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(57) Abstract 

A workflow management system which performs eight key functions: i) notifies the user that he or she has a step to begin or to 
complete (Names/Routings); ii) provides the user with the proper tools to cosx^lete a task (Transacdon Manager); iii) provides the user with 
the proper information to complete a task (Workflow Server); iv) allows the user to see where a task fits in the overall process (Schedule); 
v) manages tiie proper xemindtrs, alnts, and follow-ups to keep the process moving (Transaction Manager); vi) automates certain standard 
procedures: vii) iotegmtes wth the organization's existing business systems: and viii) provides simple application program interfaces that 
allow developers to develop new custom ^iplications that are workflow-enabled (Workflow Updater). 
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METHOD AND APPARATUS FOR MANAGING BUSINESS PROCESSES 



BRIEF SUMMARY OF THE INVENTION 

Businesses are demanding new systems that directly 
support the management of business processes, systems 
that bring order and coordination to the flow of work. 
They are seeking to automate that part of office work 
that has been impervious to conventional data processing 
and information processing systems, which were not 
designed for business process management and are not 
well-suited to help with it . 

The present invention is a system for analyzing and 
structuring business processes that, when implemented in 
software, provides businesses with the tools they need to 
manage business processes efficiently and cost- 
effectively . 

The invention can be applied to all business 
processes from simple applications, such as intelligent 
forms routing, to sophisticated mission-critical 
enterprise-wide systems that integrate all marketing, 
production, and customer fulfillment processes. 

The resulting system enables users of the system to 
take coordinated action quickly and to manage processes 
painlessly. The results are increased productivity, 
reduced cycle time and hence, improved customer 
satisfaction. 

Workf low-enabled systems facilitate business 
processes . To do so, a workflow management system 
performs eight key functions: 

•Notifies the user that he or she has a step to 
begin or to complete. 

•Provides the user with the proper tools to 
complete a task. 
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•Provides the user with the proper information to 
complete a task. 

•Allows the user to see where a task fits in the 
overall process. 

•Manages the proper reminders, alerts, and follow- 
ups to keep the process moving. 

•Automates certain standard procedures . 

•Integrates with the organization's existing 
business systems. 

•Provides simple application program interfaces 
(T^Is) that allow developers to develop new custom 
applications that are workf low-enabled . 

The workflow system' s architecture is designed to 
fit within a variety of computer systems^ collecting 
around itself not only specific applications, but also 
system enhancements and utilities from users and third- 
party developers. In addition, the architecture is 
designed to allow for interoperability among different 
applications and across diverse platforms. 

A fundamental concept of a workflow system is that 
any business process can be interpreted as a sequence of 
basic transactions called workflows. Every workflow has 
a customer, a performer, and conditions of satisfaction. 
The customer and performer are roles that participants 
can take in workflows. In addition, each workflow can 
have observers . 

In a workflow, the customer is the person for the 
sake of whom the work is done, either because they made a 
request or accepted an offer. It is customers who are 
responsible for evaluating performed work and determining 
whether this work meets their conditions of satisfaction. 
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The performer is the person who is responsible for 
completing the work and for declaring to the customer 
when the work is done . 

Requests and Offers are the two basic types of 
workflows. There are other workflow types such as 
Question, Inform and Note that are simplified derivations 
of Request and Offer. The conditions of satisfaction 
specify the work to be performed by the performer. In a 
request, the customer specifies the conditions of 
satisfaction, and in an offer the performer specifies 
them. (Then, of course, the two can enter into 
negotiation about the work to be done.) 

For example, given the sentence: 

"John asked Frank to prepare the report and deliver 

it by noon on Friday, " 
John is the customer for this workflow, Frank is the 
performer, and the conditions of satisfaction are 
"prepare the report and deliver it by noon on Friday." 
Further, because John asked for the report rather than 
Frank offering it, this workflow is of the type Request. 

Given the sentence: 

"John proposed to prepare the report and deliver it 

by noon on Friday for Frank, " 
John is the performer for this workflow, Frank is the 
customer, and the conditions of satisfaction are still 
"prepare the report and deliver it by noon on Friday." 
Further because John proposed the report rather than 
Frank asking for it, this workflow is of the type Offer. 

Observers of workflows take no direct action; they 
usually observe for management or training purposes. 

Business process maps display the workflows as 
loops, and display the relevant information about each 
workflow - the customer, the performer, the conditions of 
satisfaction and the cycle time. Figure 1 is a 
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business process map having a primary workflow 11, 
conditional workflows 13 and 15, a conditional link 17, 
parallel workflows 19 and 21, serial workflows 23 and 25. 
In a workflow system according to the present invention, 
associated with each workflow are various parameters such 
as roles, cycle time, conditions of satisfaction or 
associate semantics to the links that imply automated 
action or provide the framework for application building, 
all of which are necessary to create a useful business 
process representation. Each workflow has four phases. 
The first phase is called the proposal phase during which 
a request is made of the prospective performer by a 
customer or an offer to a customer is made by a 
prospective performer. The second phase is called the 
agreement phase during which the offer is accepted by the 
customer or the request is agreed to by the performer and 
conditions of satisfaction are identified. Of course, 
during the agreement phase the original conditions of 
satisfaction can be negotiated by the customer and 
performer until an agreement is reached. The third phase 
is called the performance phase during which the 
performer undertakes to meet the agreed to or accepted 
conditions of satisfaction. When the performer believes 
that the conditions of satisfaction have been met, the 
performer declares completion. The last phase is the 
satisfaction phase during which the customer determines 
whether or not the conditions of satisfaction have been 
met by the performer, and if so, declares satisfaction. 

In U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No, 07/368,179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present application, methods and systems for managing 
workflows, called conversations in the referenced 
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applications, are described. However, the teachings in 
the cited references are limited to single workflows with 
no capability for mapping business processes made up of a 
number of workflows linked together. In U.S. Serial No. 

filed January 15, 19 93, a method and apparatus are 

disclosed for creating and modifying business process 
maps which is a desirable but not necessary component of 
the invented system. This component is referred to as 
the workflow analyst. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is pictorial representation of a business 
process, i.e., a set of linked workflows. 

Figure 2 is a block overview diagram of a complete 
workflow system. 

Figure 3 is pictorial representation showing the 
phases of a single workflow. 

Figure 4a is a transaction manager control flow 
when it detects the initiation of a new business process 
or workflow. 

Figure 4b is a transaction manager control flow 
when it detects a change in the transactions database 
that indicates that a user (or an agent) has taken an act 
in a workflow. 

Figure 4c is a transaction manager control flow 
when it processes the workflow events of a workflow. 

DETAILED DESCRIPTION OF THE INVENTION 
OVERVIEW 

The present invention is a method and apparatus 
which is used to enable application developers to 
generate workflow enabled applications that request 
services from the workflow server. These applications 
are used by users to act and participate in business 
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processes and enable managers to observe and query the 
status of workflows and business processes. 

Definitions 

In describing the invention, the following terms 
with their indicated definitions are used: 
Act 

Basic linguistic occurrence by which people 
intervene in moving a workflow towards completion. 
Agreement 

The outcome of the negotiation phase, in which two 
parties come to a common agreement of the 
conditions of satisfaction. 

Business Process 

A network of workflows linked together that 
represent the recurrent process by which an 
organization performs and completes work, delivers 
products and services and satisfies customers. 

Business Process Map 

This is a graphical representation of business 
process, which shows its workflows and their 
relationship . 

Primary workflow 

This is the first workflow which is initiated when 
a business process is initiated. Its condition of 
satisfaction represent the condition of 
satisfaction of the business process. 
Conditional Link 

A link that indicates that only one of a group of 
workflows will be triggered based on some 
condition . 
Conditions of Satisfaction 
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Conditions declared by or agreed to by a customer. 
The fulfillment of which is the purpose of a 
workflow. 
Customer 

The role in a workflow who makes a request or 
accepts and offer. 

Customer Satisfaction 

The objective of a workflow, the accomplishment of 
which is declared by the customer when the 
conditions of satisfaction in the workflow have 
been fulfilled. 

Cycle time 

A measure of the time from initiation to successful 
completion of a workflow phase, a complete workflow 
or a business process. 
Exception flow 

The path in the business process workflow map which 
is followed if a customer cancels or a performer 
revokes or declines . 

Link 

A defined dependency between two workflows and the 
mechanism by which dependencies between workflows 
is established. 

Loops (Workflow) 

A workflow is represented graphically by an 
elliptical loop with arrows shown in a clockwise 
direction wherein each quadrant of the ellipse 
signifies different phases of the workflow. 

Normal flow 

This is the path followed in a business process map 
when workflows complete with customer satisfaction. 
Observer 

A role in a workflow who cannot perform acts in the 
workflow, but is informed of acts in the workflow. 
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and has access to the information and data 
associated with the workflow. 

Offer 

The act by which the performer can initiate a 
workflow, specifying conditions of satisfaction 
that he is willing to satisfy for a customer. 

Organization roles 

Named positions in an organization who are 
authorized to make certain requests^ agreements, 
take certain actions, set certain policies, and 
make certain decisions. The kind of roles will be 
accountant, office manager, etc. 

Performer 

One of the principal roles in a workflow: the role 
that commits to complete the conditions of 
satisfaction. 

Phase 

A characterization of the status of a workflow 
based on the acts that have happened and the acts 
that are permitted. Each workflow has four phases 
namely, the proposal phase the agreement phase, the 
performance phase and the satisfaction phase 
Request 

A customer does this act to initiate a workflow and 
declare conditions of satisfaction . 
Trigger 

An action in a workflow which causes an action in 
some other workflow. 
Triggered 

Action in a workflow based on certain 
conditions/status in some other workflow. 
Workflow 
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A structured set of acts between customers and 

performers organized to satisfy a customer's 

conditions of satisfaction. 
Workflow Activation 

A triggered action that enables the customer or 

performer of the workflow to take the initial act 

of the workflow. 
Workflow Initiation 

An act of request or offer initiates a workflow. 
Workflow Roles 

The association of participants in the workflows 

that take the acts in workflows; three roles are 

distinguished in workflows: customer, performer, 

and observer. 
Workflow Type 

This indicates whether the workflow is of request, 

offer or note type. 
Services Provided By A Workflow System 

The following describes the services provided by a 
workflow system. These . services are provided to 
applications via calls to the workflow server APIs. These 
workflow server APIs provide the main mechanism to 
interface and get access to the services provided by the 
server. In an alternate embodiment, these services can 
be provided via updates to the workflow server databases 
rather than via calls to the workflow server APIs. 
Transactions Services 

Transaction services are those related to 
initiating and acting in workflows by users and agents. 
These services are provided to workflow enabled 
applications via the transaction API. Alternatively, the 
services may be provided to workflow enabled applications 
through updates to the workflow transaction database. 
These services are also provided through the functions of 
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the workflow language specified in the definition of 
workflows . 

The services provided are as follows: 

a) Initiate a Workflow 

Through this function, an application requests the 
server to start a new workflow. For example, if a user 
fills an expense report form, when it is saved, the 
• resulting record or document represents the initiation of 
a workflow, the application will use this service to 
start the workflow. 

For example, in a workflow enabled application in 
the Lotus Notes environment (available from Lotus 
Corporation) , users initiate a new business process by 
composing a NOTES form in the transactions database. 
Users initiate workflows by editing and selecting options 
in forms. In other environments users fill in proper 
forms and the applications request the services via calls 
to the Transactions API. 

b) Act in a Workflow . 

Through this function, an application can take 
action on an existing workflow. For example, a manager's 
approval of an expense report indicates the fact the 
manager took an act in the workflow. 

c) Workflow status and available acts 
The workflow server updates and maintains the 

status of the workflow after each act is taken in a 
workflow. The server also updates the corresponding 
database records to reflect status and the available acts 
for the customer and performer such that users can see 
the workflow status and the available acts (given their 
role in the workflow) when they open the workflow 
transaction record of the transactions database or when 
they request such status from the server through one of 
the transactions API functions. 
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d) Bind and read process specx£ic dat:a (bound 
data) 

Through this function, an application binds 
application specific data to a workflow transaction. 
That is, this function allows applications to read and 
modify the process specific data (jbound data) that the 
workflow server keeps in the workflow transaction 
document. The specification of the bound data (field 
names and their data types) are defined through 
definition services. This data is directly accessible to 
the application through transactions database forms. The 
server modifies the form specification to provide 
different display attributes of fields in forms depending 
on the status of a workflow. 

e) Workflows with pending actions 

Users can request to see a list of workflows with 
pending actions of the ongoing business process, given 
the role that the user has in the different workflows of 
the process. In the NOTES environment implementation, 
these lists are available through a set of views of the 
transaction database. 

£) Available Business Process 

These appear as a functional capability of a 
workflow enabled application. The workflow server reports 
the available business processes that a workflow enabled 
application can initiate. 
Definition Services 

Definition services are those related to defining 
the elements of a business process and its workflows and 
workflow links. 

a) Define a Business Process. 



Using the workflow application builder (or other 
design application that uses the workflow definitions API 
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which is the way the application builder interacts with 
the workflow server) , users can define the workflows and 
links that constitute. a business process. In this 
connection, references herein to the workflow application 
builder should be understood as a reference to any design 
application which defines the workflows, links, 
conditional links and workflow language scripts that 
constitute a business process. The details for accessing 
the services provided by the server so that a suitable 
design application can be constructed should be apparent 
to persons skilled in the art based upon the descriptions 
contained herein . 

b) Define a workflow . 

Using the workflow application builder (or other 
design application) , users can define the structure of 
particular workflows that belong to the business process 
being defined through a set of structure definitions 
(specification of records of the workflow definitions 
database) and enable the application builder (or other 
design application) to create, modify and delete 
definition documents in the database. 

Using the workflow application builder (or other 
design application), users can specify the: 

•business processes 

•links and workflows and all their elements 
•conditional links between workflows 
•bound data 

•follow-up and reminder specification 
•automated action to be taken by the server 



Karnes and Routing Services 

Names and routing services are those related to 
defining organizational roles and identities. The names 
and routing services allow an authorized user to create. 
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modify and delete names and routing records in the 
names/routing database. These records contain the 
organizational roles and identities of the organization 
serviced by the server. They also contain the routing 
information for each identity that allows the server to 
queue notifications and reports for the proper STF 
processor. These services are specified through the user 
interface of the application builder or other design 
application that uses the names/routings API of the 
workflow server. 



a) Define organization roles. 

Using the workflow application builder (or other 
design application) and a set of APIs from the workflow 
library, users can define roles used in the organization 
where the workflow system is implemented. 

b) Define identities. 

Using the workflow application builder (or other 
design application) and a set of workflow definitions 
APIs from the workflow library, users can define 
identities in the organization where the workflow system 
is implemented, 

STF Processing Services 

The STF processing services are provided by the 
server to STF processors (described below) through an STF 
queue database. The database contains records of pending 
notifications and reports to be given to specific users 
in applications that the STF processors service. STF 
processors process and delete these records once they are 
processed. 
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Configuration Services 

The configuration services are provided to the 
system administrator through a specific configuration 
database. Through a workflow server manager which is a 
user interface that uses the server administration API, 
the system administrator can define the network 
configuration of the system, the version of the servers, 
register STF processors, define the authorized users, 
specify the log database and the level of logging 
required. 

Scheduling Services 

The scheduling services allow an authorized user to 
create, modify and delete records of scheduled business 
processes. These records specify the date/time when the 
server must initiate a business process as well as the 
recurrence in which this initiation should happen. These 
services are specified through the user interface in the 
application builder. 

External Interfaces 

External interfaces provide services that are used 
by end-user applications, the workflow application 
builder, the workflow reporter and the STF processors, 
some of these services, such as configuration services, 
are provided through specific user interfaces; others are 
provided by the workflow APIs. In an environment like 
NOTES (available from Lotus Corporation) , where the 
client interfaces interact with the databases directly, 
client workflow-enabled applications access the databases 
directly to obtain workflow services. They do not use a 
programmatic API; instead they read and write workflow 
structures that are interpreted by the workflow server. 
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In other environments workf low-enabled applications 
access the workflow services through the workflow APIs. 
Network Architecture 

The workflow server component of a workflow system 
is designed to be installed at a single site> managing a 
single set of databases. It can manage one or many 
♦ business processes, and, as noted above, each business 

process can contain one or many workflows . 

The workflow server is configured through a 
configuration database. When the workflow server starts, 
it begins to monitor and update the workflow databases as 
appropriate. Each workflow server can monitor multiple 
definitions, transactions, or scheduling databases, as 
specified in the configuration database. 

In the NOTES environment distributed access to 
business process databases is achieved through the 
replication mechanisms of NOTES. 

The transactions database managed by the workflow 
server can be replicated through the standard mechanisms 
of NOTES. In this way, distributed access for viewing and 
changing business process status is achieved. 

A business process is designed in such a way that 
all the workflows that are part of the business process 
are stored and managed in a single NOTES (or other 
workflow enabled application) database. This database is 
then managed by a single workflow server for agent 
processing and workflow language interpretation. 

As a stand-alone server in the Microsoft Windows 
environment, a special version of the workflow server 
having a restricted functionality of services allows 
users of workf low-enabled applications to take action and 
move workflows to completion, but does not include the 
services of automated agents or of execution of workflow 
language scripts. 
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components of a Workflow System 

A workflow system incorporates the following 
components which are shown in Figure 2. a workflow server 
and databases, application program interfaces (APIs, and 
workflow server manager. In addition, a complete 
workflow system of the type in which the present 
invention may be utilized includes an application 
builder, analyst, standard transaction format (STF) 
processors, workflow enabled applications and "P-^" 
components. The application builder, analyst, standard 
transaction format (STF) processors, workflow enabled 
applications and reporter components, while useful 
components of a complete workflow system, do not form 
part of the present invention and details concerning such 
components are set forth herein only as needed for an 
understanding of the invention. 

The following is a brief overview description of 
the workflow server, databases, APIs and workflow server 
n^nager which is followed by a detailed description of 
these components. Details concerning the remaining 
components are provided only as needed for a complete 
understanding of the invention. In the preferred 
embodiment as set forth below, the invented system is 
implemented using the Model, View, Class (MVC) paracigm 
of object oriented programming, 
workflow Server 

The workflow server is the center of a workflow 
system. The workflow system concentrates workflow 
operations in the workflow server rather than in the end 
user applications. By using this client /server design, 
applications do not need to have the intelligence about 
workflows as part of their design. Application developers 
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can concentrate on their particular application 
development not having to worry about workflow logic and 
overhead because such functionality is handled at the 
server , 

Figure 2 shows the major components of the 
workflow server in relation to other components of a 
workflow system. These components are referred to as 
processes and modules. All work done by the server is 
performed by one of four processes which are referred to 
as the transaction manager^ follow-up manager, date/time 
schedule manager and STF schedule manager. Processes are 
software components or tasks that are architected to run 
as separate entities from each other. The workflow server 
controls the four basic processes based upon workflow 
system server administration data in a configuration 
database in the following manner. First/ it determines 
what STF processors need to run and spawns those 
processes . Second, it determines when to run the 
transaction manager and spawns that process. Third, it 
determines when to run the follow-up manager and spawns 
that process. 

These processes may be separate executables or 
simply separate tasks within the body of the workflow 
system server. 

Workflow server modules are software components 
that provide a specific type of .functionality. Modules 
are used by the above processes and also among 
themselves . 

Organizationally the modules can be thought of as 
separate libraries. These modules are the workflow 
processor, workflow updater, the workflow instantiator , 
the workflow language interpreter, the workflow event 
handler, the agent actions manager, and the STF 
router/enqueuer manager. 
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Databases 

The workflow system utilizes the followxng 

databases : 

Definitions Database 

The definitions database contains records of the 
definitions of the organizations, business P---^; 
workflows, roles, and acts. These records — ""JJ^^ 
instructions of what needs to be done in a ^l^^'^^l ^J 
,iven instance. These records are used by the workf 1 w 
!pdater and workflow processor to determine new workflow 
states and available actions. 

Transactions Database 

The transaction database contains records or the 
enactment of workflows. Bach time a workflow is -^-^^^^ 
or an action taken within a workflow, a corresponding 
record is made in the transactions database. These 
records include the workflow instances, the action 
transactions, the current incompletions , and the 
relationships between different workflows. 

Haines /Routings Database 

The Names/Routings database contains records of the 
roles and identities of the organization where the 
workflow system is installed. It records the ex.stxng 
organizational roles, the current identities and the 
authorizations to act in one or more roles. 

Schedule Database 

The schedule database stores the date and time when 
a business process must be initiated. The date/time 
schedule manager reads this database. 

Administration/configuration Database 
This database stores information needed by the 
workflow server to operate. 
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STF Queue Database 

This database stores the records of notifications 
to be sent to users that interact with the workflow 
system through an STF processor interface. 

Horkflow APIs 

The workflow APIs provide a programming interface 
to access the services of the workflow server. Workflow 
enabled applications, STF processors (described below) 
and the application builder are all developed using these 
APIs. APIs of the invented system are as follows: 
transaction API, definitions API, reporter API, names and 
routings API, schedule API and administration API. 

Workflow Server Manager 

The workflow server manager is a component of the 
workflow system that provides a user interface for 
specific services of the workflow server such as: 

Server Management 

Authorization Maintenance 

Business Process Maintenance 

Workflow Maintenance 

STF Processor Maintenance 

Con f igurat ion 

Transaction Log Maintenance 

Business Process Scheduling and Organizational 
Calendar 

The WSM uses the workflow APIs to implement the 
functions and services it provides to users. Through the 
use of the WSM, a user selects the scheduling function 
which provides the user interface to specify the 
recurrent scheduling of business processes as well as the 
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specification of the organizational calendar as specified 
by the schedule manager. 
Workflow Application Builder 

The workflow application builder is a Graphical 
User Interface (GUI) application that allows a business 
process designer to specify the business process design 
with its network of workflows. The application builder, 
in turn, creates or edits the workflow definitions 
databases that define the business process and that will 
be used by the workflow server. The functions performed 
by the workflow application builder can alternatively be 
performed by a design application that uses the workflow 
definitions API of the workflow server. 
Workflow Ajialyst 

The workflow analyst is a GUI application that 
allows a business process analyst to specify the map of 
business processes with its network of workflows- Its 
output is readable by the application builder or 
equivalent which will update the definitions database of 
the server. Details concerning the workflow analyst may 

be found in co-pending U.S. Serial No. filed 

January 15^ 1993, 
Workflow Reporter 

The workflow reporter is a GUI application that 
provides an interface to the transaction databases 
through the workflow reporter API of the system. It 
allows the observation of the status of current 
transactions as well as the history and performance of 
past transactions . Further details concerning the 
workflow reporter are not needed for a complete 
understanding of the present invention. Alternatively, 
such reports can be provided by an application that uses 
the workflow reporter API. 
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STF Processors 

An additional set of mechanisms for developing 
workf low-enabled applications are provided in a workflow 
system through the definition of a standard transaction 
format (STF) . This format defines the semantics for 
accessing the workflow services through different types 
of interfaces: messaging, databases and inter-process 
communication . 

For each one of these types of interfaces there is 
a syntactic definition that specifies the specific format 
for the representation of the workflow data and the 
process specific data in that medium. This syntax 
definition constitutes an STF API that a particular 
application will then use. 

The communication and interface between workflow- 
enabled applications that do not use the workflow APIs 
and the server is provided by STF processors. These STF 
processors map and translate between a workf low-enabled 
application's data format and the workflow APIs data 
elements. 

STF processors provide a layer for integration of 
many different protocols and technologies. STF processors 
can be constructed for any message transport environment 
protocol, database technology, and inter-process 
communication protocol. 

The interface from STF processors to the server is 
accomplished through the workflow APIs. From the point of 
view of workflow services, the STF processors appear to 
the server as additional applications. 

A standard transaction format (STF) processor is an 
application whose job is to interface external systems to 
the workflow system. There is one STF processor for each 
different type of system that interfaces to the workflow 
system. 
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Workf low-Enabled Applications 

A workflow-enabled application interfaces to the 
server via the workflow APIs or via direct access to the 
transactions database of the workflow server, or via the 
use of an STF processor which can use different 
interfacing mechanisms such as messaging, database or 
inter— process communication. 
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DESIGK AND XKPZ«£K£MTATION DESCRIPTIOH 
A . WORKFZiOW SERVER 

The workflow server is a set of processes, modules, 
databases and APIs as set forth above. The following is 
a description for implementing the processes, modules, 
databases and APIs of the workflow server. Also 
described is a workflow server manager which provides a 
user interface for specific services of the workflow 
server . 
Processes 

Transaction Manager (TM) 

The TM starts all the actions that must happen when 
there is a change in the transactions database. The TM 
is the driver for processing requests made by users 
through workf low-enabled applications. The transaction 
manager determines what changes in the transaction 
database have occurred. Records that have changed in the 
database are detected by the TM. The transaction manager 
manages a transaction queue and services queued 
transactions in FIFO order. Transactions may be entered 
directly by a user via forms available in workflow- 
enabled applications, which use the workflow transactions 
APIs to request the services of the workflow server, or 
they may be rec[uested via an STF Processor. 

A workflow record that has changed, falls into one 
of several different categories. It may be: 

A request for initiation of a new business process; 

A request for initiation of. a new workflow within a 
business process; or 

A request for an act within a workflow. 

Each of the different types is dealt with 
differently . 

When there is a business process or workflow 
initiation 



SUBSTITUTE SHEET (RULE 26) 



wo 94/18620 



24 

PCT/US94/01287 



Figure 4a shows the control flow of the transaction 
manager when it detects the initiation of a new business 
process or workflow. In this case the transactions 
database will contain the record for the business process 
or the workflow being initiated. 

In Flow #1 the transaction manager detects the 
initiation of a business process or workflow in the 
transactions database , 

In Flow #2 the transaction manager calls the 
Instantiator Module, which will instantiate the workflow 
records based on the definition of the business process. 

In Flow #3 the instantiator reads the definition of 
the business process or workflow from the definitions 
database . 

In Flow #4 the Instantiator creates all the new 
transaction records for the corresponding workflow or the 
business process . 

Figure 4b shows the control flow of the 
transaction manager when it detects a change in the 
transactions database that indicates that a user (or an 
agent) has taken an act in a workflow. 

In Flow #1 the transaction manager detects the 
workflow act being taken in the transactions database . 

In Flow #2 the transaction manager calls the 
workflow updater to begin processing this newly updated 
transaction record. 

In Flow #3 the workflow processor calculates next 
available acts, new incompletions, etc. 

In Flow #4 the next available actions, 
incompletions, etc. are written to the transaction 
records . 

In Flow #5 the workflow updater checks the names 
database to see if one of the identities participating in 
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the workflow being processed needs to be notified via an 
STF processor. 

In Flow #6 if an identity has been identified in 
Flow #5 that needs to be notified via an STF processor, 
then the transaction is queued in the STF queue database. 

Figure 4c shows the control flow of the 
transaction manager when it processes the act and state 
events, which are also referred to herein as workflow 
events, of a workflow. In the definitions database, each 
workflow definition includes workflow language segments 
(scripts) that are associated with each act and stai:e of 
the workflow. 

In Flow #1 the transaction manager invokes the 
workflow event handler indicating the workflow, act and 
state that should be processed. 

In Flow #2 the workflow event handler reads the 
script for the act from the definitions database. 

In Flow #3 the workflow event handler invokes rhe 
workflow language interpreter to process the script. 

In Flow #4 If the script indicated that an action 
needs to be taken, the workflow language interpreter 
calls the agent actions manager to take the workflow act 
on behalf of the user. 

In Flow #5 the agent actions manager updates iihe 
transactions database to reflect that an act has been 
taken . 

The workflow event handler then repeats Flow #2, 
but in this case reads the script for the state of the 
workflow. The process continues to Flow #3 with respect 
to the state. 

The workflow event handler repeats Flow #2 and Flow 
#3 for the script that corresponds to the current szate 
of the primary workflow of the business process. 
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In the preferred embodiment, the transaction 
manager is implemented as follows. The transaction 
manager identifies changes that have taken place in the 
workflow transaction database and invokes the proper 
server modules to provide the services that have been 
requested or that those changes represent. The 
transaction manager queues and services incoming 
transactions by instantiating a transaction-type-specific 
object . 

The date/time the transaction was entered is given 
along with its type and id. This date/time field is used 
to do FIFO (first in-firat out) queue retrievals. The 
earliest date/time will always be retrieved first. 

ITXTD is the id of a transaction in the Transaction 
Database . These ids are txtyp e dependent and can be used 
to access transactions directly from the database. 

The following is a description in pseudo-code for 
implementing the transaction manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
transaction manager and disconnects from the Virtual 
Database . 
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The primary activity of the transaction manager is 
checking the workflow transactions database for requests 
to process. It performs this primary activity by a call 
to the function MainLoop. 

In case of an error, the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to a log 
provided by the workflow server manager described 
below . 

3. If connection is not successful, write a message to 
the log and return . 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return. 

MainLoop 

This function performs the primary activity of the 
transaction manager. In an unconditional loop, it checks 
if any message has been sent from the workflow server 
manager (WSM) and processes it. It then performs the main 
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activity of checking for workflow requests and invokes 
either the workflow updater or the agent/action manager. 

1. Check for any message for the transaction manager 
from the WSM. To retrieve messages, the method 
Kfr,r.o^M^.^^ae of class MF,f>SftfiEO is called. In case of 
any error, the error is written into the log file. 

2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the transaction 
manager, the function is terminated. 

4. If the message is to indicate that the configuration 
has changed then do the following: 

• 5. The new configuration is retrieved using method 
y.fnr,^^r»n.F^aTnfo of class rONFTGINFO . The new 
configuration is returned in a structure that 
contains all the configuration information. In case 
of error in retrieving the configuration information, 
the error is written in the log file. 

6. The configuration database specifies the polling 

interval and the log verbosity options. The polling 
interval is the time the transaction manager sleeps 
between processing cycles. The log verbosity option 
specifies the amount of information that gets written 
into the log file. The function ftWPWri fftTnLoq is 
used to log activities into the log file. 



7 . Invoke workflow updater . 
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8. Invoke the agent actions manager. 

9. Sleep for a time interval of duration Polllnterval . 

10. Proceed to step 1. 

Follow Up Manager 

The follow-up manager runs periodically, scheduled 
per workflow server administration tables in the 
administration/configuration database. It can run 
asychronously to the transaction manager. It determines 
when notifications, either follow up or reminders, are to 
be sent and sends them- 

The follow-up manager detects transactions in which 
a participant has an overdue commitment and, depending on 
the workflow definition stored in the definitions 
database, will execute a script, send a mail message, or 
take other actions that are defined. The follow-up 
manager interacts with a Workflow Incompletion 
Transaction class which is part of the transaction 
database, which furnishes follow up and reminder times, 
in order to select workflows requiring notification. 

Follow up is specified in the workflow definition. 
This specification is done through the application 
builder or equivalent. For each workflow, a follow up 
specification can be made for each one of the roles of 
the workflow as follows: 

Specify when the follow-up will be done 
First and last valid times 
Recurrence interval 

Holidays on which not to follow-up (Optional) 
Days of week on which to follow-up (Optional) 
Time ranges in which to follow-up (Optional) 
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HOW many times to follow-up before stopping 
Specify incompletions to be followed up on 

Customer response due 

Performer response due 

Performer fulfillment due 
Soecifv the type of check 

Will be coming due (reminder) and how soon 

IS past due (follow-up) by how much 
specify what to do for the follow-up 

in each workflow transaction, the current 
incompletions for each role are kept as indexed records, 
in addition to the date for the incompletion, the record 
will contain a field for the next date and time ror 
follow up as well as the next date and time for reminder. 
The records will be indexed on these two date fields as 
well . The follow-up manager works off these incompletion 
records . 

The follow-up manager checks if the first follow-up 
or reminder date/time is due "now" and that "now" is not 
a restricted date/time according to the organizational 
calendar, and if so, retrieves the workflow language 
script and passes it to the Workflow Language Interpreter 
for processing. The follow-up manager deals appropriately 
with the case that the server has been down and processes 
all entries that are past due. 

The following is a description in pseudo-code for 
implementing the follow-up manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 



MAIN 
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The MAIN function connects to the Virtual 
Database (VDB) r performs the primary activity of the 
follow-up manager and then disconnects from the VDB. 

The primary activity of the follow-up manager is 
checking for overdue commitments and then sending 
reminders or follow-up messages. It performs this primary 
activity by a call to the function MainLoop . 

In case of an error, the MAIN function performs a 
write to an error log^ giving the error code and the 
message. The flow of the MAIN function is as follow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to the 
log . 

3. If connection is not successful, write a message to 
the log and return, 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return . 

MainLoop 
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This function performs the primary activity of the 
follow-up manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then checks for commitments due and 
sends follow-up and reminder messages if required. The 
flow of MainLoop is as follows: 

1. Check for any message for the follow up manager from 
the (WSM) . To retrieve messages, the method 
bfnGetMessage of class MESSAGEQ is called. In case of 
any error, the error is written into the log file. 



2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the follow-up manager, 
the function is terminated. 

4- If the message is to indicate that the configuration 
has changed, then do the following: 

5. The new configuration is retrieved using method 
bfnGetConfiglnfo of class CONFIGINFO. The new 
configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written to the log file. 

6. The configuration database specifies the polling 
interval and the log verbosity options. The polling 
interval is the time the follow-up manager sleep 
between processing cycles. The log verbosity option 
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specifies the amount of information that gets written 
into the log file. 

7. The function FollowUp is called to perform the main 
activity of the follow-up manager. 

8. Sleep for a time interval of duration Polllnterval . 



9. Proceed to step 1. 



FollowUp 

The FollowUp function scans the Incompletions table 
of the transactions database and determines which 
incompletions are due for reminder or follow-up. The 
processing is done in two passes, one for reminders and 
the other for follow-ups. 



1. Set a flag to indicate if it is a reminder or follow- 
up pass. 

2. Get the current time. This time will be the basis for 
selecting incompletions which are due. If the 
incompletions are prior to the current date then the 
incompletion is processed. In case of error in 
getting the current time, log an error and return. 

3. Using methods of class TXWFINCQMPLETIQN from the 
transactions database, the incompletions due for 
processing are retrieved. Methods 

bfnaRtFT r.di-Tncompi Pi-ion and bf nGetNext Incompl et ion 
retrieve the incompletions that are due. 
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If an incompletion is due (reminder or follow-up) , 
methods of class TyWFTNr-OMFTiT.TTON are called to get 
the Business Process Id (IfiZlid) , the Workflow Id 
(IHEXid) and the Incompletion type(lncld). The 
following methods are used: 



Value 


Methods 


BPTid 


IfnGetBPTid 


WFTid 


IfnGetWFTid 


Incid 


fnGetlncId 



5. The workflow associated with the incompletion is 
retrieved from the VDB . An instance of the class 
TvwTTTTj.qTANCE is Created. The 1 BPT i d and the "'WFT i d 
are passed as parameters. 

6. Depending on the incompletion, the workflow 
participant is determined. The logic for determining 
the workflow participant is as follows : 



Notification 
Tvpe 


Xn completion 
Type 


Workflow 
Role 


Reminder 


rnstomer His Comoletion 


Performer 


Follow-uo 


Customer His Resoonse 


Performer 


Follow-uo 


nncmomer His Comoletion 


Performer 


Follow-uo 


Performer His Resoonse 


Customer 



7. Check if the Identity needs notification. The 
Identity attributes are retrieved from the VDB. These 
are stored in table NPPFTPf.NTTTY . If the Notification 
flag is set then the follow-up/reminder information 
is sent to the workflow participant. The notification 
information is retrieved using method ^f nGf tNot i f V • 

8. If notification is required, then retrieve the STF 
Processor Id, by using method 1 f nr.pf PTFFrocId of 
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class HT^nPTm^tKTITY . The notification is placed in the 
STF queue of this STF processor. 

9. The notification event is determined by the following 
table: 



Incomoletion Tvpe 


Event Tvoe 


Customer His 
Completion 


Performer Completion coming due 


Customer His Response 


Performer Response past due 


Customer His 
Completion 


Performer Completion past due 


Performer His 
Response 


Customer Response past due 



10. Get the time when the incompletion was due i.e. the 
Completion Time (this is not to be confused with the 
completion time of the workflow) . 

11. Get the reminder or follow-up time, i.e. the time 
this notification was due. (Note: It is important to 
distinguish between incompletion due time and 
reminder and follow-up due time) . 

12. Dispatch notification. The notification is placed 
in the STF Queue. Method ^fnPutEvent. of class 
Tyj^^TFOrTEUE places the notification, 

13. Determine when the next notification is to be sent. 
Get the workflow notification definition. This 
contains recurring information . The next follow-up 
time is determined and written to the incompletion 
table via method y.f nP^tFol 1 owUpTime . 



14. Get the next incompletion to be processed. If 
present, proceed to step 4. 
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15. Return, processing is complete. 

Date/Time Schedule Manager 

The date/time schedule manager detects events which 
are to be executed at a particular time. The scheduled 
events are kept in the schedule database. The events are 
placed in the database by the workflow server manager 
user interface via calls to the schedule API and are 
processed by the schedule manager. The scheduled events 
are kept in the database in chronologically increasing 
order . 

A schedule database entry specifies when the event 
will be done as well as the first and last valid times 
for the entry, indicating the first time it should happen 
and when it should stop happening. If the first and last 
valid times are the same, the schedule entry is executed 
once . 

A recurrence interval for a schedule entry is "how 
often" the schedule entry is executed. Recurrence 
intervals may be every X minutes, every hour, every day, 
every month, the third Thursday of every month, and so 
forth. 

An organizational calendar is connected to the 
schedule manager, so that entries may be tagged to not 
happen on specific days (such as weekends or holidays 
like Labor Day) . 

The schedule entry may be filtered to happen only 
on particular days of the week (such as Monday through 
Friday) . 

The schedule entry may be filtered to happen only 
during particular time intervals (such as any time 
between 8-12 or 1-5) 

The first thing that the schedule manager does in a 
cycle is to find events that are due now (or which are 
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past due) . This is done by finding those with a time-out 
time that is less than "now". 

For each of the found entries, the schedule manager 
then brings the time-out forward to "now", even if it is 
currently set in the past. This function should deal 
properly with the case when the server has been down. 

For each of the found entries, the schedule manager 
then passes the business process initiation script to the 
Workflow Language Interpreter for processing. 

After the schedule entry is processed, the schedule 
manager updates the schedule entry record for the next 
time out based on the parameter set for it. If the entry 
needs not be executed again, it is then removed from the 
schedule database , 

The following is a description in pseudo-code for 
implementing the schedule manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
. Database (VDB) , performs the primary activity of the 
Scheduler and disconnects from the Virtual Database. 

The primary activity of the schedule manager is to 
find business processes that are scheduled for initiation 
and start them . 

In case of an error the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 
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1. Connect to the Virtual Database. 

2. If connection is successful write an message to the 
log , 

3. If connection is not successful, write a message to 
the log and return. 

4. Call function MainLoop . 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write an message to 
the log 

7. If disconnection is not successful, write a message 
to the log and return . 

MAINLOOP 

This function performs the primary activity of the 
schedule manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then performs the main activity of 
scheduling business processes at the scheduled time. 

1. Check for any message for the schedule manager from 
the WSM. To retrieve messages, the method 
>-.fnr;<=^i-MfifiRaae of class MESSAGEQ is called. In case of 
any error, the error is written into the log file. 
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2. Depending on the message, the message is processed 
dif f erent ly^r according to steps 3 and 4 below. 

3. If the message is to terminate the schedule manager, 
the function is terminated. 

4. If the message is to indicate that the configuration 
has changed then do the following: 

5. The new configuration is retrieved using method 
bfnC^g^tConf ioTnf n of class mWFTCTWFO. The new 

configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written in the log file. 

6. The configuration constitutes the polling interval 
and the log verbosity options. The polling interval 
is the time the Scheduler sleeps between processing 
cycles. The log verbosity option specifies the amount 
of information that get written into the log file. 

7. The function Scheduler is called, this performs the 
main activity of the schedule manager. 

8. Sleep for a time interval of duration Polllnterval . 

9. Proceed to step 1. 
Scheduler 

The Scheduler function scans the scheduler table of the 
schedule database and determines which business processes 
are ready to be scheduled. 
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1. Get the current time. This time will the basis for 
selecting business processes which are due to be 
started. If the initiate time of the business process 
is after the current date then the business process 
is initiated. 



2. Using methods of class SCBPSCHEDULE the business 
processes due for initiating are retrieved. Methods 
bfnGetFirstlncompletion and bf nCetNext Incompletion 
retrieve the business processes that are due. 

3. Get the Business Process Definition Id (BPDid) . Use 
method IfnGetBPDid of class SCBPSCHEDULE. 



4. Get the Business Process Definition. Create an 
instance of class DFBP for definition id BPDid, 

5. Get the Business Process Name. Use method 
vfnGetBPName of class DFBP. 

6. Initiate the business process. Transactions API call 
AWSTINITBP is called. The Business Process Name is a 
parameter to this call. 

7. Determine the next time the Business Process needs to 
be scheduled. The Recurring Offset is retrieved using 
methods If nGetRecTime of class SCBPSCHEDULE. 

8. If the Recurring Offset is specified, the next 
initiate time is computed by adding the recurring 
offset to the current initiate time. 
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9. If the Recurring Offset is not specified, the 
scheduling entry is deleted from the table. 

10. Get next Business Process to be initiated. If 
present, proceed to step 3. 

11. Return, processing is complete. 
Modules 

Workflow Processor 

The workflow processor is the Jbrain of the workflow 
system. The workflow processor is analogous to the 
central processor unit (CPU) in a computer. Both 
processors receive inputs in the form of events, and both 
carry out logic computations . The CPU embodies a logic 
processor, while the workflow processor embodies the 
logic of workflows with phases, cycle times, actions and 
roles. It contains the structures and Finite State 
Machines (FSMs) that specify the acts and actions that 
are available. This module is database independent, and 
provides an API through which the rest of the system 
interfaces with it. It is furnished with in-memory 
structures providing complete act/state data of a 
workflow, from which it derives updated status 
information returned via these structures. The workflow 
processor embodies the logic of workflows with phases, 
actions, roles and dates of completion and reply. 

The basic logic of the workflow server is very 
similar to that used by a human manager. It asks: 

• What actions have happened and not happened? 

• What data has changed? and 

• What amount of time has elapsed? 
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The workflow updater module of the workflow server 
asks the workflow processor: 

• What are the available acts for the customer 
and performer given the current state and the 
type of the workflow? 

• Given an act, what is the new state of- the 
workflow and what incomplet ions change? 

The workflow processor then answers with the state 
of the workflow and gives the answer to the workflow 
updater which updates databases, and changes the state of 
the workflow. 

These tasks would be impossibly complex if the 
number of states were large and the possible actions 
infinite. The present invention addresses this problem by 
defining a business model that intelligently defines a 
few conditions and actions as building blocks, but from 
which thousands of permutations can be constructed. 

A complete description of a suitable workflow 
processor which may be used in a workflow server may be 
found in U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No. 07/368,179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present applicat ion . 

Hork£lo%r Updater 

The workflow updater module processes requests made 
by users via API calls, changes to the transaction 
database or by agent actions. This module processes 
workflow transactions that have been modified, updating 
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them with the new workflow status information returned by 
the workflow processor. 

The workflow updater module updates the bound data 
in the business process, based on the data that was 
provided as part of the act that is being taken. If other 
scopes are defined for a workflow, then the bound data is 
updated in the scope of the workflow in which the act was 
taken. 

The workflow updater calls the workflow processor 
passing to it the workflow identification, the act being 
taken, the workflow role that is taking the act and the 
current state. The workflow processor returns to the 
workflow updater the new state of the workflow, the 
incompletion transitions (what incompletions need to be 
set, and which ones need to be removed), the set of 
available acts for each one of the workflow roles and the 
times that can/must be specified by the users when taking 
each one of these available acts . 

The workflow updater maintains and updates the 
workflow transaction data±>ase. It uses the workflow 
processor to determine the status of workflows and the 
set of possible actions for each one of the roles. 

The workflow updater processes an act taken by a 
workflow participant i,e., the Customer or Performer. 
This act could have been taken through a call to the 
proper transactions API function, through a direct 
modification of the transactions database or by the agent 
actions manager upon request of the workflow language 
interpreter. When an act is taken, it is recorded in a 
act taken database record of the transactions database . 
The server sequentially processes all acts. The following 
is a description in pseudo-code for implementing the 
workflow updater module. 
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1. Use method of the Trfansloq class of the 
Administration database to log the act taking 
activity. 

2. Check whether there are acts to take by calling 
method ^^n(^^tFir c:1- mon^n^ of class TxWTActS in the 

VDB. 

3. Check if the act is a valid act and the act is 
present in the list of available acts for an workflow 
participant by invoking method bf nCheckValidAct of 
class TwxFActs in the VDB. 

4. Find out the current state, WF type, WF role, and the 
Act by invoking respectively the methods 
-Fnnf^tvjF.qt-ate . f nap^t wFTvoe . f n^^f^t WFRole , and fnGetAct 
of class T ^WFActs in the VDB. 

5 . Check with the workflow processor to determine if the 
act taken is consistent with the current state of the 
workflow and the role of the act taker (Customer 
/Performer) by invoking method T>f nChfiCkValidAct. of 
the class TvwFActs . 

6. Determine the new state of the workflow by calling 
the workflow processor. 

7 , Compute the new set of incompletions by by calling 
the workflow processor. 

8. Compute the new set of acts and the date prompts for 
the customer and performer using function 
AWSTAva j 1 eActs of the workflow processor. If any 
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acts are disabled then those are removed form this 
new set of acts using the method hf nTsDiaabled of 
class DFX<rrDisahlf>dActs of the VDB. 



9. Invoke the workflow event handler to interpret the 
scripts associated with the act, state, and the 
primary workflow. 

10. Send notifications the workflow participants 
informing the completion of the act by invoking the 
STF Router/Enqueuer . 



Classes and the methods invoked by the workflow updater 
module: 



Methods 


Class 


Action 


bfnCheckValidActs 


TxWFActs 


check if act is in 
Available Acts 
Table 


If nGetCompletionTime 


TxWFInstance 


From VDB retrieve 
the Completion 
time 


IfnGetlncompletionTime 


TxWFActs 


From VDB retrieve 
the Incompletion 
Time 


AWS T A va i 1 ab 1 e Act s 




compute available 
acts for both 
customer and 
•oer former . 



Workflow Instant lat:or 

The workflow instantiator module is called by the 
transaction manager when it detects a request to initiate 
an instance of a business process or a workflow. The 
workflow instantiator instantiates business process and 
workflow records into the transactions database. This 
module creates workflow transaction records as specified 
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in business process definitions whenever a workflow is 
initiated • 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new business process, the instantiator 
reads the business process definition and creates the 
transaction records for the business process and for the 
primary workflow of the business process according to the 
definition . 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new workflow, the instantiator reads the 
workflow definition and creates the transaction record 
for the workflow according to the definition. 

The instantiator also performs the role to identity 
mapping so that the roles that are specified in the 
workflow definition get mapped to the proper identities 
in the transaction record of the workflow. 

The following is a description of the steps for 
implementing the workflow instantiator module. 

The instantiator creates an instance of a business 
process. It makes a copy of the definition. 

1. Check the length of the Business Process Name 
(SZEEMame.) is within limits. If beyond limits, return 
error. 

2. Validate the Instantiator Identity. Check if the name 
length is within limits. 

3. Check if Instantiator Identity is a valid user and 
registered. Method TngiH rf^Anthori zation from class 
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Anr,hMa-ini- -i r used to determine if the user is valid and 
registered. This function accesses the Names /Routings 
database for validation^ it calls the constructor of 
class NRDF IDENTITY. 

4. Check if the Instantiator Identity is authorized to 
instantiate business processes. It checks the authorities 
ta^le in the names/routings database to check if this 
identity is authorized to instantiate business processes. 
The authorization method Inguire ^Anthor j gation from class 
AnthMaint is called to determine the authorization. 

5. If the Customer name is specified, check if the name 
length is within limits. 

6. It the Customer name is specified, check that this 
name is valid and registered, method TnguirgAuthorizat ion 
from class AiithMai nt is used to determine if the u3er is 
valid and registered. This function accesses the 
Names/Routings database for validation, it calls the 
constructor of class NRDFIDENTITY . 

7. If the Performer name is specified, check if the name 
length is within limits. 

8. If the Performer name is specified, check that this 
name is valid and registered. Method InquireAuthorizat ion 
from class AiithMaint is used to determine if the user is 
valid and registered. This function accesses the 
Names/Routing databases for validation, it calls the 
constructor of class NRDFIDENTITY. 

9. If the Completion date is specified, check if the date 
string length is within limits. 
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10. If the Completion date is specified, convert the date 
string to long format. 

11. If the Reply date is specified, check if the date 
string length is within limits. 

12. If the Reply date is specified, convert the date 
string to long format . 

13. If the Initiate date is specified, check if the date 
string length is within limits. 

14. If the Initiate date is specified, convert the date 
string to long format. 

15. If Completion and Reply dates are specified, the 
Reply date should be before the Completion date, 

16. If the Initiate date, if specified, it should be the 
earliest of all specified dates. 

17. Create an instance of this business process. The 
constructor for class Ty^T^TN.<^TANCE is called for this 
purpose . 

18. The central workflow instance is created. The 
constructor for class TvwPTwgTAWCE is called for this 
purpose . 

19. Check for each organization role to identity any 
mapping which is specified at the time of initiation 
which overrides the mapping specified in the definition 
of the workflow, that the organization role and identity 
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do exist. To verify that the organization role is 
present/ the constructor for class >JRnFORP;ROT,R is called. 
To verify that the identity is present, the constructor 
for class nrdftdentity is called. 

20. Store the organization role in classes TXBPA5;.STr;N and 
TywFA5^5^TC;N from the transaction database classes to 
identity overrides. The constructors are called for these 
two classes. 

2 1 . Return status . 

Workflow Language Interpreter 

Workflow definitions are stored in the definitions 
database. Included in these workflow definitions are 
conditions under which workflows become active and 
inactive, and the conditions under which the workflow 
server should take specified actions. These conditions 
and instructions are expressed in the workflow language. 

The workflow language interpreter interprets 
workflow language scripts. These scripts or workflow 
language segments contain workflow commands such as the 
initiation or taking an act in a workflow. These scripts 
are part of the business process definition. These 
scripts are automatically generated by the application 
builder or equivalent design application. 

The following is a description of the steps and 
syntax for implementing the workflow language interpreter 
module. 

The workflow language interpreter interprets both 
user defined and system generated script s, and performs 
the corresponding function defined in the script. The 
user can perform the following functions on a workflow. 
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The workflow language interpreter interprets user-defined 
as well as system generated scripts, and performs tests, 
functions, and assignments as presented in either kind of 
script. The syntax and capability of the Act ionWorkf low 
scripting language are the same for the two kinds of 
scripts and is described as follows: 



Language Syntax 

A statement of the language is either an If 
Statement, an Action Statement or an Assignment 
Statement . 



An If Statement is either: 

If <boolean expression> statement 
1 , . . statement n endif 

or 

If <boolean expression> statement 
1. . .statement s else statement s+1 ... statement 

n endif 

where <boolean expression> is: 

TRUE 
FALSE 

<boolean express ion> AND <boolean 

expression> 

<boolean express ion> OR <boolean 

expression> 
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<bounci data name> OPERATION <numeric 

term> 

ISINSTATE (workflow name, state name) 
ISNOTINSTATE (workflow name, state name) 

where OPERATION is 

equal to 
not equal to 
greater than 

greater than or equal to 
less than 

less than or equal to 
An Action Statement is either: 

INITIATE workflow name, 
ACTIVATE workflow name, or 
ACT workflow name, act name 

An Assignment Statement is either: 

<bound data name> = <bound data name> 

or 

<bound data name> - <numeric term> 
2 . Capability 

The above-described syntax enables a script writer 
to start workflows, to act in workflows, to change bound 
data associated with a workflow, to test bound data 
associated with a workflow and conditional upon the 
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results follow one or another distinctly different course 
of action. 

The workflow language interpreter can be divided 
into the following functional modules: 

1. The Lexical Analyzer which defines the Workflow 
Language grammar , 

2. The Parser which parses the workflow scripts and 
invokes the corresponding semantic routines associated 
with the commands in the script. 

The main implementation details are as follows: 

1 . The workflow event manager calls the workflow 
language interpreter and passes to it the Business 
Process Transaction ID, the Workflow Transaction ID, and 
the Script Type to be executed. 

2 . Using this information the workflow language 
interpreter retrieves the appropriate workflow script 
from the definitions database using method 
hf nC^et.SrrS pi-Name of the class PFWFfiCtState > 

3. For the command Instantiate, the instantiator is 
invoked. 

4. For the command Activate, the workflow updater is 
invoked 

5. For the command TakeAnAct, the workflow updater is 
invoked. 

6. For external functions, the workflow language 
interpreter invokes the external function passing the 
specified parameters. 
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Workflow Event Bandler 

The workflow event handier is called by the 
transaction manager to process the actions associated to 
acts and states in the workflow definition which are 
specified for a given workflow when an action is taken or 
a state reached in the workflow. It accomplishes this by 
reading the business process definition and by reading 
the workflow status information of the workflow 
transaction , 

The workflow event handler also looks in the 
definitions database for the workflow language scripts 
associated with acts and states of the workflow. The 
workflow event handler retrieves the language script 
corresponding to the act that was taken and passes the 
script to the workflow language interpreter for 
processing. The workflow event handler retrieves the 
language script corresponding to the state of the 
workflow and passes the script to the workflow language 
interpreter for processing. Then the workflow event 
handler retrieves the appropriate scripts associated with 
the states of the connecting workflows and passes them to 
the workflow language interpreter. Finally the workflow 
event handler retrieves the language script for the 
primary workflow of the business process for the current 
state of that workflow and passes that script to the 
workflow language interpreter for processing. 

The following is a description of the steps for 
implementing the workflow event handler module. 
The workflow event handler invokes the method 
AWSScriptToExecute of the workflow language interpreter 
to execute the following scripts associated with a 
workflow: 
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The system generated act script 

2. The user generated act script 

3. The system generated state script 

4 . The user generated state script 

5. The system generated state script of all the 
connected workflows 

6. The user generated state script of all the connected 
workflows 

7. The system generated state script of the primary 
workflow 

8. The user generated state script of the primary 
workflow 

To implement steps 7 and 8, the method 
bfnIsCentralWF of class obTxWF INSTANCE is used to 
determine the Current WF is the primary workflow. Method 
obWFInstance is used to obtain the primary workflow. 

Agent Actions Manager 

The agent actions manager module executes the 
commands specified in a script. These include Initiate, 
Act, Follow-up as well as external functions. In this 
form the agent action manager is taking workflow acts by 
an "agent" on behalf of some role in the workflow. The 
commands that the "agents" execute are specified through 
the workflow language . 
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The following is a description of the steps for 
implementing the agent actions manager module. 

The agent actions manager is invoked by the 
workflow language interpreter when it finds a workflow 
action or external function to be performed in a workflow 
language script. If the workflow needs to be instantiated 
the instantiation is done by the workflow instantiator 
module. After instantiation a flag is set to indicate if 
activation or initiation is required. The agent action 
manager scans for all workflows which have this flag set 
and processes them. The process is described below. 

1. Log the activity using the method AWSWriteToLog . 

2. Obtain the current date and time. 

3. Get the next workflow to act on by using method 
TxWFINSTANCE of class TXWFINSTANCE, which is the act 
to take queue. 

4. If the workflow to be processed is the primary 
workflow then change the Business Process status to 
"IN_PROGRESS" . The methods to use are bf nIsCentiralWF 
and bFnSetBPStatus . 

5. If the Customer^ Performer and Observer (s) are not 
specified/, then pick up defaults and assign all the 
workflow participants . The methods to use are 
IfnGef.Cuj^Md, 1 f nC;et:Per f Id , 1 f nPnt CuRt Id and 

IfnPutPerf Id. 

6- Specify the default Reply and Completion time using 
methods IfnGetReplayDat,^ and 1 f nQetiComplet j onTime of 
class TxWFINSTANCE . If these times not present, 
obtain them through the definition defaults by using 
methods bf naet^CycleTimes of class PFWrCYnLFTTMES in 
the VDB. Assign the default using the methods 
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h-FnPnt Rf^niynaf R and H-rpPnt-.CoTnnI i onTinie of class 

TvVJFTW<:^TANCE. 



7. Set up environment for first act to be taken. The act 
is dependent on the workflow type, reguest act in a 
workflow of type request and offer act in a workflow 
of type offer. 

8. Make an entry in the Available Acts Table using 
method bfnPutAct of the class obAvlActs. 

9. Take the first act if the workflow is to be 
Initiated, The act to be taken is placed in the act 
to process queue using method obTxWFActs of class 
TXWDACTS. Log the message using AWSLogMessage . 

10. The flag is reset to indicate that the processing 
is complete using method bf nResetlnstantiate of class 
obTxWFInstance . 

Methods and Modules invoked by Agent Actions Manager 



Module 



Methods 


Class 


Action 


IfnGetBPTid 


TxBP INSTANCE 


get the BP 
Transaction Id 


IfnGetWFTid 


TxWF INSTANCE 


get the WF 
Transaction Id 


bfnSetBPStatus 


TxBP INSTANCE 


set the status of 
BP instance 


IfnGetPerf Id 




get the performer 
Id 


IfnGetCustId 


TxWFNSTANCE 


aet the customer Id 


IfnGetCompletionTime 


TxWFNSTANCE 


get cycle t ime of 
the WF 


TxWFActs 




queue the act to be 
taken 
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STF Router/Enquouer 

The STF Router/Enqueuer module is called by the 
workflow updater to determine if the workflow currently 
being processed has a participant who must be notified in 
this workflow via an STF Processor, The router queues 
such transactions in the STF queue database for the 
appropriate STF processor to process. 

The following is a description of the steps for 
implementing the STF router/enqueuer module. 

1. The STF router/enqueuer first retrieves the BP and WF 
definition given the current WF transaction instance 
by using the methods TXRP TNj^TANCS and obTxWFInstance 

of classes TyRPTW.STANCE and TyWFTW.qTANCK . 

2. Using the BP and WF Ids, the follow-up definition is 
retrieved from the definitions database using method 
DFWFollowUp of class DFWTFQLLQWUP > If no 
notification required, just return. 

3. Get the notification status by using method 
NRDfTdentity of class NRDFIDENTITY . If there is no 
need to do notification, just return. This is 
achieved through the method hf naf^t-Notif v- of class 
NRPf Identity in the vdb. 

4. Get the STFProcId using method If nGetSTFProcId of 
class NRDf Identity ■ 

5. Write the Notification event in the STF queue 
database using method bfnPutEvent of class 
TyfiTFOUEUE . The date and time is computed. 

Databases 
Virtual Database 
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The present invention utilizes a Virtual Database 
for implementing the databases used by the system. The 
Virtual Database (VDB) is designed to be a collection of 
classes and methods. "Virtual" because it is DBMS 
independent. The VDB contains all the necessary storage 
structures to support the operations of the Workflow 
Server. More importantly, it defines a collection of 
methods for the manipulation of these structures and 
their instances- The basic domain as well as the classes 
for workflow definitions, transactions, schedules, names 
and routing, STF queue and server administration and 
configuration are described below. These classes define 
the attributes and methods for the data manipulation 
supporting the Workflow Server. 

Basic Domain Classes 
The basic domain classes used in the server are listed 
here in alphabetic order. 

acb 

act = { requestf offer, decline-request, agree, declare- 
complete, declare-satis fact ion, cancel, revoke, 
accept-off er, decline-offer, counter-offer, accept- 
counter-off er, decline-counter-offer, counter-with- 
request, declare-dissatis faction, question, answer, 
inform, open-speculation, continue-speculation, 
revise-offer, revise-request, follow-up, note, 
comment, initiate, activate, cancel-new-request, 
revoke-new-promise, revoke-new-offer, commit-to- 
commit, interim-report, delegate, accept- 
delegation, decline-delegation, cancel-delegation, 
declare-complete-de legation, declare-satis faction- 
delegation, revoke-delegation, start-with-promise, 
accept-starting-promise, decline-starting-promise } 
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bpstatus 

bpstatus = { InprogresSf completedf aborted, suspended ) 

configuration 

configuration = { optlonl, opt±on2f . - . } 

datetime 

Time is a built-in domain in the Virtual Database. Its 
counter part in the underlying DBMS will provide the 
actual implementation. 

da-betlmeoffset 

Datetimeof f set is a unit of time. Its value can range 
from seconds, days, weeks, and months, but is expressed 
in seconds . 

incompletlon 

The various incompletions that need to be managed for the 
Customer and Performer in terms of Completions and 
Responses . 

incompletion = { CMC, CMR, CHC, CHRr PMC, PMR, PHC, PHR } 

1st letter C for Customer, P for Performer 

2nd letter - M for My, H for His 

3rd letter - C for Completion, R for Response 

notification 

This domain class specifies the events which require 
notification . 

notification = {PerformerResponsePastDue, 

PerformerCompletlonPastDue, PerformerCompletionComlngDue, 
CustomerResponsePastDue, Act ) 

ob jecttype 

objecttype = { BP, WF, STFProcessor } 
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privileges 

privileges = { create, delete, modify^ activate, 
schedule, assign privileges ] 

st:ate 

state = { request/offer, inactive, initial (after 
activation) agreement, completion, satisfaction, counter, 
decline, cancel revoke } 

st:ring 

String is defined to be a character string with varying 
length. 

Status of the a transaction, 

txstatus = { pending, inprogress, complete ) 
txtype 

List of various types of transactions processed by the 
server. 

txtype = { initbpr initwf, actinwf, hindappdata, 
gethounddata, getbounddatafieldattributes, status, 
availahleacts, querywf, availablebp, acthistory, 
not ificationst ring } 

w£role 

wfrole = { customer, performer,, observer } 
wf type 

wftype = { request, offer, note } 



Definitions Database 
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DFBP 

This class contains the Business Process (BP) definitions 
which includes information such as the BP Name^ the BP 
Version, The person (ID) who created the BP, The date 
when this information was last modified, The Server ID 
which is the Home Server of this BP and the name of the 
file which contains the mapping of this BP . 



Attributes: 



IDEN 




CHAR 


SzBPName fBPNAME LEN] 


INT 


iVersion 


IDEN 


IBP Admin 


LONG 


ILastModDate 


IDEN 


IHomeServerld 


CHAR 


s zBPmao r BLOBNAME LEN) 
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DFBP 


THo Pon T-uctor of this Class: 
Depending on its first 
parameter it returns the ^ first 
r^rn-rci from the table which 
matches the predicate, or 
creates a new Business Process 
■in Table with the qiven 
parameters, or creates a new 
version of an existing 
Business Process with the 
aiven parameters 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the DFBP 
r-lae?*? at-tributes 


IDEN IfnGetBPDid 


Returns the BPDid of the BP in 
context to the Class 
attributes 


INT ifnGetVersion 


Returns the BP Version of the 
BP in context to the Class 
attributes 


IDEN IfnGetLastModDate 


Returns the Date when the BP 
Definition was last modified 
in context to the Class 
attributes 


BOOL DfnPutBPMap 


rT-^^ka-hfa ct /Anrsends to the Map 
file of the BP, the data in 
memory . 


BOOL OriUjetBlrMap 


pctf- ovR^ the soecified number 
of bytes from the Map file. 


BOOL bfnNumListBP 


Returns the Number of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListBP 


Returns the List of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListDFBP 


Returns the list of all BPs 
defined in the Definitions 
Database . 


VOID vfnGetBPName 


Returns the BP Name of the BP 
in context to the Class 
attributes 



DFWF 

This class contains the Workflow definitions which 
include information such as the WF Name, the WFDid, the 
BPDid to which this workflow belongs, the type of 
workflow (primary or non primary) , the default IDs of the 



SUBSTITUTE SHEET (RULE 26) 



63 

WO 94/18620 PCT/US94/01287 

customer and performer for this WF, the Repeat IF adn 
factor in case of repetitive WFs, the form names and the 
Conditions of satisfaction 



At:trlbu1:es 




IDEN 


IBPDid 


IDEN 


IWFDid 


BOOL 


bCentralWFFlaa 


CHAR 


szWFName fWFNAME LENT 


WFTYPE 


WFTvpe 


IDEN 


ICusOraRole 


IDEN 


IPerOraRole 


INT 


iRepeatFieldId 


INT 


iRepeatFieldFactor 


CHAR 


szCustFormName fFORMNAME LENl 


CHAR 


szPerFormName fFORMNAME LEN] 


CHAR 


szObsFormName [FORMNAME LENl 


CHAR 


szInitFormName fFORMNAME LENl 


CHAR 


szCOSrCOS LENl 
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Methods : j- 
DFWF 


Constructor of this class 
which depending on its first 
parameter it returns the 
first record from the table 
which matches the predicate 
or creates a new Workflow 
Definition in the Table with 
the aiven parameters 


BOOL bxnMoaiiy 


Modifies the Workflow 
Definition of an existing 
workflow (in context of the 
Class attributes) in the 
Table with the given 
parameters 


BOOL brnMoaityt orms 


Modifies the form names of 
an existing workflow (in 
context of the Class 
attributes) in the Table with 
the aiven form names 


BOOL bfnPutCOS 


Appends/ Creates the 
conditions of satisfactions 
of an existing workflow (in 
context of the Class 
attributes) in the Table with 
the aiven COS 


BOOL bfnGetCOS 


Retrieves the Conditions of 
Satisfaction of an existing 
workflow (in context of the 
Class attributes) 


IDEN IfnGetWFDid 


Returns the WFDid of an 
existing workflow (in context 
of the Class attributes) 


WFTYPE fnGetWFType 


Returns the WF type of an 
existing workflow (in context 
of the Class attributes) 


IDEN IfnGetCustOrgRole 


Returns the customer ID of an 
existing workflow (in context 
of the Class attributes) 


IDEN IfnGetPerfOrgRole 


Returns the Performer ID of 
an existing workflow (in 
context of the Class 
attributes) 



DFWFOBS 



This class contains 'the workflow observer 
definitions which includes information such as the WFDid, 
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the BPDid to which this workflow belongs, the Observer ID 
for the WF. 



Attributes 



IDEN 


IBPDid 


IDEN 


IWFDid 


IDEN 


lObserver 



DFWFOBS 


The constructor for this 
Class, which depending on 
its first parameter it: 
creates a new Workflow 
Observer Definition in the 
Table with the given 
parameters, or returns the 
first record from the table 
which matches the predicate 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the 
DFWFOBS class attributes 


BOOL bfnGetWFObsList 


Returns the List of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 


INT nfnGetWFObsCount 


Returns the Number of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 



DFBPCONTAINER 

This class contains the Business Process Container 
Information (the Container ID for a particular BP) . 

Attributes : 



IDEN 


IBPDid 


IDEN 


IContainerld 
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Methods^ 

DFBP CONTAINER 



IDEN IfnGetContainerld 



Creates a new Container 
Definition for a BP with the 
given parameters (in context 
of the Class Attributes) It 
also inserts a record in 
another table (DFCONTAINER) 
with the Container ID and 
the number o f fields 



Returns the Container ID (m 
context of the Class 
Attributes) 



DFFIELD 

This class contains the Container Field Information 
which includes the Container ID to which the field 
belongs, the Field ID ,the data type of the field, .ts 
maximum length, its attributes, and its initial Value. 



Attributes^ 



IDEN 



ATTRIBUTES 



IContainerld 



IFieldId 



iPataTvpe 



iMaxLen 



Attr 

gzInitVal [TKTT VAL LENl 



Methods 

DFFIELD 



Creates a new Container 
field record with the 
given parameters. It 
also inserts a record in 
another table 
(DFBDFIELDLIST) with the 
BPDid, the Field ID and 
the field name. 



DFLINK 

■ This class contains the Workflow Link Information 
which includes the BPDid to which this LINK belongs, the 
ID of the workflow from which the LINK starts, whether 
the link starts from an act or from a state, the 
act/state IDs from which the Link starts and at which 
link ends, and the Destination State ID. 
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Attributes : 



IDEN 


IBPDid 


IDEN 


TFi-omWFid 


BOOL 


bFrortiActOrState 


IDEN 


IFromActOrStateld 


IDEN 


IToWFid 


BOOL 


bToActOrState 


STATE 


ToState 



Methods : . 

DELINK 


The Constructor for this 
Class that creates a new 
Link record with the ^ 
given parameters. Using 
WFName WFID is first got 
from DFWF 


BOOL bfnGetWFLinks 


Returns all the links to 
a aiven WFID 



DFBPASSXGH 

This class contains all the Identity to 
Organization role mappings at the Business process 



Attributes 



IDEN 


IBPDid 


IDEN 


lldentitvid 


IDEN 


lOraRole 



Methods : 

DFBP ASSIGN 


The constructor of this 
class that depending on 
its first parameters 
creates a new BP 
assignment in a given 
BPDid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN IfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 



DFHFASSIGM 

This class contains all the Identity to 
organization role mappings at the Workflow li 
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Attributes : 



IDEN 


IBPDid 


IDEN 


IWFDid 


IDEN 


lldentitvid 


IDEN 


lOraRole 


WFROLE 


WFRole 



Methods 



DFVfF ASSIGN 


The constructor of this 
class that depending on 
its first parameter it 
creates a new workflow 
assignment in a given 
WFDid and BPDid with the 
given parameters or 
returns the first record 
from the table which 
matches the oredicate 


IDEN IfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 


DFBPNOTIFICATION 

This class contains all notification string 
information at BP level. 

Attributes : 



IDEN 


IBPDid 


NOTIFICATION 


NEvent 


CHAR 


szNstrinafNSTRING LEN] 



DFBPNOTIFICATION 


This is the constructor for 
this class that creates a 
new BP notification for a 
criven BPDid 


BOOL bfnGetEventString 


Returns the BP notification 
strincr of an event in a BP 



DFWFNOTIFICATION 

This class contains all notification string 
information at workflow level 
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Attributes 



IDEN 


IBPDid 


IDEN 


IWFDid 


NOTIFICATION 


NEvent 


CHAR 


szNstrinafNSTRING LEN] 



Methods 



DFWFNOT IF ICAT ION 


This is the constructor 
for this class that 
creates a new workflow 
notification for a given 
WFDid and BPDid 


BOOL bfnGetEventString 


Returns the workflow 
notification string of an 
event at workflow level . 



DrWFCYCLETIMES 

This class contains all the Cycle times defined for 
a workflow. 

Attributes 



IDEN 


IBPDid 


IDEN 


IWFDid 


LONG 


ITimel 


LONG 


lTiine2 


LONG 


ITimeS 


LONG 


lTime4 


Methods : 



DFWFCYCLETIMES 


This is the constructor 
for this class that 
creates a new record with 
the given cycle times for 
a aiven WFDid and BPDid 


BOOL bfnGetCycleTimes 


Returns the cycle times 
(in context of the Class 
Attributes) 


DFWFCYCLETIMES 


Returns the first record 
from the table which 
matches the predicate 


IDEN IfnGetWFDid 


Returns the WFDid (in 
context of the Class 
Attributes) 



DFWFD I S ABLED ACT S 

This Class contains information of all the Disabled 



Acts 
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Attributes 



IDEN 


IBPDid 


IDEN 


IWFDid 


WFROLE 


WFRole 


ACT 


Act Id 


Methods : 



DFWFDISABLEDACTS 



This is the constructor 
for this class that 
creates a new record 
with the given WFrole 
and Actid for a given 
WFDid and BPDid 



BOOL bfnIsDisabled 



Returns whether a 
particular Act for a 
particular WFRole in a 
given workflow is 
disabled or not. 



DFWFACTSTATE 

This contains all the definitions of the workflow 
acts and States (their names and IDs) for all business 
processes and their workflows. 



IDEN 


IBPDid 


IDEN 


IWFDid ^ , 


BOOL 


bActOrState 


INT 


ActOrState 


CHAR 


szUserDefName fUSERDEF STRING LENl 


CHAR 


szGenScriPt fBLOBNAME LENl 


CHAR 


szUserScrit)t fBLOBNAME LENl 



private Ke-cnoas : 

BOOL bfnIsAvail 


Returns whether an Act/ 
state is Available for a 
aiven Workflow* 


BOOL bfnGetScriptName 


Returns the Script Name 
given the BP and WF DIds 
the Act/State and the 
type of script (User 
Defined or System 
Generated) reouired . 
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Methods 



DFWFACTSTATE 


This is the Constructor 
for this Class that 
creates a new record with 
the given Act/State , and 
user defined name for a 
qiven WFDid and BPDid 


BOOL bfnPutScript 


Inserts the given Script 
into a blob file 


DFWFACTSTATE 


Returns the first record 
from the table which 
matches the predicate 


BOOL bfnGetWFScript 


Returns the required data 
from the script file (In 
context of the Class 
Attributes) given the 
Script Tvpe 



DFWFCONTAINER 

This class contains the Workflow Container 
Information (the Container ID for a particular workflow 
in a given BP) . 

Attributes ; 



IDEN 


IBPDid 


IDEN 


iWFDid 


IDEN 


iContainerld 



Methods : 



DFWFCONTAINER 


Creates a new Container 
Definition for a workflow with 
the given parameters (in 
context of the Class 
Attributes) 


IDEN IfnGetContainerld 


Returns the Container ID (in 
context of the Class 
Attributes) 



DFWFACTSTATEBDREF 

This Class contains the workflow Act/State Bound 
Data reference information. 
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IDEN 


IBPDid 


IDEN 


IWFDid 


BOOL 


bActOrState 


INT 


ActOrStateld 


WFROLE 


WFRole 


IDEN 


IContainerld 



DFWFACTSTATEBDREF 


The Constructor for 
this Class that 
inserts a record 
with the with the 
aiven parameters 


IDEN IfnGetContainerld 


Returns the 
Container ID (in 
context of the Class 
Attributes) 


BOOL bfnGetFieldAttrList 


Returns the list of 
Field Attributes for 
the given conditions 
(parameter values) 


BOOL bfnGetNumFieldAttrList 


Returns the number 
of Field Attributes 
for the given 
conditions 
(parameter values) 



DFWFFOLI.OWUP 

This class contains all the Follow-up information 
of a workflow- 
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Attributes 



IDEN 


IBPDid 


IDEM 


IWFDid 


BOOL 


bPRFUFlaa 




bP'RPTTl^^r'ii T" 

la/C^ £Vk \J X>- w LI J- 




■A. c rvt w ^ ^ o c w 


INT 


iPRFUCount 


BOOL 


bPCFUFlacr 


BOOL 


bPCFURecur 


LONG 


IPCFUOffset 


INT 


iPCFUCount 


BOOL 


bCRFUFlaq 


BOOL 


bCRFURecur 


LONG 


ICRFUOffset 


INT 


iCRFUCount 


BOOL 


bPCRemFiaq 


LONG 


IPCRemOffset 


BOOL 


bActNotifvFlaa 



Methods : 



DFWFFOLLOWUP 


The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
FollowUp Table with the 
Given Parameters or 
returns the first record 
from the table which 
matches the predicate 


BOOL bfnGetPerf RespInf o 


Returns the Performer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerf Complnfo 


Returns the Performer 
Completion Information 
(in context of the Class 
Attributes) 


BOOL bfnGetCustRespInf o 


Returns the Customer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerf Remlnfo 


Returns the Performer 
Reminder Information (in 
context of the Class 
Attributes) 


BOOL bfnGetActNotifyFlag 


Returns the Notify flag 
(in context of the Class 
Attributes) 
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DFBDFIEI*DIiIST 



IDEN 


IBPDid 


char 


szFieldName fFIELDNAME LENl 


IDEN 


IFieldId 



Methods : 

No Methods 



Transactions Database 



TXBPINSTANCE 

This Class contains information of all instances o 
Business Process Transactions. This information consist; 
of the Transaction ID of the Business Process (BPTid) , 
the Business Process definition ID (BPDid) , the BP Stati 
and whether the BP Instance is active or not. 



Attributes 



IDEN 


IBPTid 


IDEN 


IBPDid 


BOOL 


bis Active 


BP STATUS 


BPStatus 



Methods : 



TXBP INSTANCE 


The Constructor for this Class 
that returns the first record 
from the table which matches 
the predicate 


Create Instance 


Creates an instance of the 
given BP in the Transactions 
Database table 

(TXBP INSTANCE) . bIsActive will 
still be FALSE 


BOOL bfnActivate 


Changes the Status (bIsActive) 
of the current BP (In context 
to the Class Attributes) from 
FALSE to TRUE 


BOOL bfnSetBPStatus 


Sets the BPStatus to the given 
status ID (In context to the 
Class Attributes) 


IDEN IfnGetBPDid 


Returns the BPDid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


IDEN IfnGetBPTid 


Returns the BPTid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


BOOL bfnNumListBP 


Returns the number of BPs that 
have been Instantiated 


BOOL bfnListBP 


Returns a list of all BPs that 
have been Instantiated to 
memory or to the file 
specified 


BOOL bfnDelete 


Deletes the BP transaction 
(specified by the class 
attributes) from the table. 


BOOL bfnAbort 


Sets the BPStatus to ABORT (In 
context to the Class 
Attributes) (Further Actions 
are vet to be defined) 


BOOL bfnSuspend 


Sets the BPStatus.to SUSPEND 
(In context to the Class. 
Attributes) (Further Actions 
are yet to be defined) 
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BOOL bfnNumListQueryQF 


Returns the number of BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPS are included where 
Acts are oendinq) 


BOOL bfnListQueryWF 


Returns a list of all BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, • having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPS are included where 
Acts are pending) 



TXBPASSIGN 

This class contains all the Identity to 
Organization role mappings at the BP level for BP 
Transaction. These mappings if present override the 
corresponding DFBPASSIGN mapping for a given BPDid for 
that particular instance of the BP (BPTid) . 



Attributes 



IDEN 


IBPTid 


IDEN 


lOraRole 


IDEN 


lldentitvid 



Methods : 



TXBPASSIGN 


The constructor of this 
class that depending on 
its first parameter 
creates a new BP 
a s s i gnme nt in a g i ve n 
BPTid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN If nGet Identity 


Returns the Identity ID 
(in context of the Class 
attributes) 
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TXWFXNSTANCE 

This Class contains information of all instantiated 
Workflows. This information consists of the Transaction 
IDs of the Workflow (WFTid) and the Business Process 
(BPTid) to which it belongs, whether it is a Primary 
workflow or not, the Workflow definition ID (WFDid) , the 
reply, completion and initiate date, the present State, 
the Customer and Performer for this workflow Instance, 
the conditions of satisfaction for this workflow and 
whether this workflow instance has been instantiated or 



not 




Attributes 




IDEN 


IBPTid 


IDEN 


IWFTid 


BOOL 


bCentralWFFlaa 


IDEN 


IWFDid 


DATETIMET 


IReplvDate 


DATETIMET 


IComoletionTime 


DATETIMET 


llnitiateTime 


STATE 


Stateld 


IDEN 


ICustId 


IDEN 


IPerf Id 


BOOL 


bCOSFlacr 


CHAR 


szCondOfSatisfn [BLOBNAME LEN] 


BOOL 


binstantiate 
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TXWF INSTANCE 


The Constructor for 
this Class that returns 
the first record from 
the table which matches 
the predicate 


BOOL bfnInstantiateCentraiWF 


Creates an Instance of 
the Primary workflow of 
a BP Instance, given 
the BPDid and BPTid 
with the given 
parameters . For the 
given BPDidf the 
workflow with CWF Flag 
TRUE is fetched from 
the DFWF table to 
create this CWF 
instance. A new WFTid 
for this workflow 
Instance is returned 


BOOL bfnCreatelnstance 


Creates an Instance of 
the non Primary 
workflow of a BP 
Instance, given the 
BPDid and BPTid with 
the given parameters. A 
new WFTid for this 
workflow Instance is 
returned 


BOOL bfnSetState 


Sets the STATE of the 
given workflow Instance 
to the state specified. 


BOOL bfnGetlnstantiate 


Returns the Status of 
the Instantiate flag 
for the given workflow 
Instance (In context of 
the Class Attributes) . 
This indicates if the 
specified workflow 
instance has been 
instantiated or not. 


BOOL bfnModify 


Modifies the specified 
parameters in the 
WFInstance (In context 
of the Class 
Attributes) and returns 
the WFTid 


IDEN IfnGetCustId 


Returns the Customer ID 
for the given workflow 
Instance (In context of 
the Class Attributes) 
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IDEN IfnGetPerfId 


Returns the Performer 
ID for the given 
workflow Instance (In 
context of the Class 
Attributes) 


BOOL bf nGetStateName 


Returns the User 
Defined State Name 
corresponding to the 
current state of the 
workflow Instance. (In 
context of the Class 
Attributes) . 


BOOL bfnGetFormNajne 


Returns the form name 
(corresponding to the 
WFRole) of the workflow 
Instance. (In context of 
the Class Attributes) 


BOOL bfnIsCentralWF 


Returns TRUE if the 
current WF is a primary 
WF 


IDEN IfnGetBPTid 


Returns the BPTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


IDEN IfnGetWFTid 


Returns the WFTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


BOOL bfnReset Instantiate 


Sets the Instantiate 
Flacr to FALSE 


IDEN IfnGetWFDid 


Returns the WFDid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


STATE ifnGetState 


Returns the current 
State of the given 
workflow Instance (In 
context of the Class 
Attributes . 


BOOL bfnGetPending 


Return whether or not 
an act is pending for 
this Workflow Instance 


BOOL bfnPutCOS 


Creates/Appends to the 
Blob file of the 
workflow Instance, the 
COS data in memory 
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BOOL bfnGetCOS 


If the COSFlag is TRUE 
it retrieves the 
specified number of 
bytes from the Blob 
file of this workflow 
Instance containing the 
Conditions of 
Satisfaction else the 
COS is retrieved from 
the workflow 
Definitions table 


BOOL bf nPutCustld 


MnHS'Fiex? the Customer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes ) 


BOOL bfnPutPerfId 


Modifies the Performer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes) 


LONG IfnGetReplyDate 


Returns the Reply date 
for this workflow 
Instance (in context of 
the Class attributes) 


LONG IfnGetCompletionTime 


Returns the Completion 
date for this workflow 
Instance (in context of 
the Class attributes) 


BOOL ornFUuKep J-yuai-e 


Modifies the RetJlv date 
for this WF Instance to 
the given date (in 
context of the Class 
attributes ) 


BOOL bfnPutCompletionTime 


Modifies the Completion 
date for this WF 
Instance to the given 
date (in context of the 
Class attributes) 


BOOL bfnGetCOSFlag 


Returns the COS Flag 
for this workflow 
Instance (in context of 
the Class attributes) 


BOOL bfnPutCOSFlag 


Modifies the COS Flag 
for this WF Instance to 
the given value (in 
context of the Class 
attributes) 
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TXWFOBS 

This class contains the Workflow Observer 
Transactions information which includes information such 
as the WFTid, the BP Instance (BPTid) to which this 
workflow belongs, and the Observer ID for the workflow 
instance . 



A'ttribu^es 

private : 



IDEN 


IBPTid 


IDEN 


IWFTid 


IDEN 


lObserver 



Methods 



TXWFOBS 



The constructor of this 
class that depending on 
its first parameter it 
creates a new Workflow 
Observer Transaction in 
the Table with the 
given parameters or 
returns the first 
record from the table 
which matches the 
predicate 



TXWFASSXGH 

This class contains all the Identity to Organization role 
mappings at the Workflow level for Workflow Instances. 

Attributes : 



private : 



IDEN 


IBPTid 


IDEN 


IWFTid 


IDEN 


lOraRole 


IDEN 


lldentitvid 


WFROLE 


WFRole 
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TXWF ASSIGN 


The constructor of this 
class that depending on its 
first parameter returns the 
first record from the table 
which matches the predicate 
or creates a new workflow 
assignment in a given WF 
Instance (WFTid) for a BP 
Instance (BPTid) with the 
aiven parameters 


WFROLE fnGetWFRole 


Returns the WFRole (in 
context of the Class 
attributes) 


IDEN IfnGetldentity 


Returns the Identity ID (in 
context of the Class 
attributes) 



TXWF I KCOMP LE T I ON 

This class contains the Incomplet ions informarion 
for all Instantiated workflow 



IDEN 


IBPTid 


IDEN 


IWFTid 


INCOMPLETION 


Incid 


LONG 


IComoletionTime 


LONG 


IFollowUpTime 


LONG 


IReminderTime 


LONG 


ICount 
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Methods : 



TXWF INCOMPLETION 


The Constructor for 
this class that returns 
the first record from 
the table which matches 
the predicate or 
inserts a new workflow 
Incompletion for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
the qiven parameters 


IDEN IfnGetBPTid 


Returns the BPTid for 
the workflow Instance 
(in context of the 
Class attributes) 


IDEN IfnGetWFTid 


Returns the WFTid for 
the workflow Instance 
(in context of the 
Class attributes) 


INCOMPLETION fnGetlncId 


Returns the 

Incompletion ID for the 
WF Instance (in context 
of the Class 
attributes) 


DATETIMET 
If nGetCoitiDlet ionTime 


Returns the Completion 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutCompletionTime 


Modifies the Completion 
time for this workflow 
Instance to the criven 
time (in context of the 
Class attributes) 


DATETIMET If nGetFollowUpTime 


Returns the FollowUp 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutFollowUpTime 


Modifies the follow up 
time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


DATETIMET If nGetReminderTime 


Returns the Reminder 
Time for the workflow 
Instance (in context of 
the Class attributes) 
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VOID vfnPutReminderTime 


Modifies the Reminder 
Time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


BOOL bfnGetFirstlncompletion 


Returns TRUE xf a 
record for the given 
reminder/followup prior 
to the given time is 
available and the 
Incompletion 
information is made 
available in the Class 


BOOL bfnGetNext Incompletion 


Returns TRUE if the 
next record for the 
given reminder/followup 
prior to the given time 
is available and the 

T /^TTiT^ 1 O 1 OT^ 

XnCOlujJXti L- 

information is made 
available in the Class 
Attributes . 


LONG IfnGetCount 


Returns the Count 
(number of 

incompletions) for the 
workflow Instance (in 
context of the Class 
attributes) 


VOID vfnIncCount 


Increments the count. 



TXWF AVA I L ACT S 

This class contains information of available acts 
Workflow Instance . 



Attributes 




IDEN 


IBPTid 


IDEN 


IWFTid 


WFROLE 


WFRole 


ACT 


Act 


BOOL 


bReplvFlaa 


BOOL 


bComoletionFlacr 
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Methods 



TXWFAVAILACTS 


The constructor for this 
Class that returns the 
first record from the 
table which inatches the 
predicate or inserts a 
new Available Act for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
the aiven oarameters 


BOOL bfnNumA vail Acts 


Returns the nuinber of 
Acts available for a 
given WFRole in a 
WFInstance . The Impure 
piafT indicates whether 
an Act is waiting to be 
processed by the 
Transaction Manager 


BOOL bfnList 


Returns tne xisu or acus 
available for a given 
PJFRole in a WFInstance. 
The Impure Flag 

xriClx^OL'Ca WiiCL.iid. 0.11 u> 

is waiting to be 
processed by the 
Transaction Manager 


ROOT, tj-f nDeleteAllActS 


Deletes all the Acts for 
a given worlcflow 
instance from the 
Available Acts table 


BOOL bfnGetReplyFlag 


Returns the value of the 
Reply Flag for the WF 
Instance (in context of 
the Class attributes) 


BOOL bfnGetCompletionFlag 


Returns, the Completion 
Flag for the workflow 
Instance (in context of 
the Class attributes) 



TXWFACTS 

This class contains information of Acts that are to be 
taken (Queue) in all Workflow instances . (Acts taken by 
the client but not yet processed by the Server) , 
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IDEN 


ITxId 


BOOL 


bSTFFlaa 


IDEN 


IBPTid 


IDEN 


IWFTid 


ACT 


Act id 


WFROLE 


WFRole 


LONG 


lReplv'T'3-me 


LONG 


IComolf^tionTime 


IDEN 


IWho 


DATETIMET 


IWhenReqistered 


DATETIMET 




BOOL 


bProcessed 


LONG 


IReturnCode 
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Methods ; 



TXWFACTS 


The Constructor for this 
Class that or inserts a 
new WF Act into the 
table (ActId) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters or inserts a 
new WF Act into the 
table (ActId) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters . It also 
inserts a record in the 
table TXSTFADDINFO or 
returns the first record 
from the table which 
matches the oredicate 


IDEN IfnGetTxId 


returns the Tx ID for 
the Act that has to be 
taken (in context of the 
Class attributes) 


■ROOT. H"Fnfipa"t- Rf*1~ urn s 


Returns the parameters 
STFProcId, ReturnCode 
from the current Class 
attribute values. It 
also returns STFTxID and 
User Id (from 
TXSTFADDINFO) 


VOID vfnPutRetValue 


Modifies the Return 
Code . 


BOOIi bfnGetFirstlnQueue 


Returns the first Act 
(to be processed ) from 
the Queue) 


VOID vfnActComplete 


Updates the bProcessed 
flaQ to TRUE 


BOOL bfnCheclcValidAct 


Checks if the given Act 
is valid for the WFRole 


IDEN IfnGetBPTid 


Returns the BPTid to 
which this Act belongs 
(in context of the Class 
attributes) 


IDEN IfnGetWFTid 


Returns the WFTid to 
which this Act belongs 
(in context of the Class 
attributes) 
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ACT fnGetAct 
WFROLE fnGetWFRole 


Returns the Act id o£ 
t-his Act belongs (in 
context of the Class 

attributes) 

Returns the WFRole 
taking this Act (in 

of the class 
attributes) 


STATE fnGetWFState 


Returns the State of 
this Act (in context of 
^vna r'laoc «1-1-T" ibut e s ) 


WFTYPE fnGetWFType 


Returns the WFType (got 
from DFWF) of the 

-^V-^T «-vTj t*jVlT(**h this 

worJcrJ-ow tt? wj.ij.wii 

Act belongs (in context 

r.^= Class attributes) 


DATETIMET 
IfnGetlncompletionTime 


Returns the 
completion /reply time 
for the given 
Incomoletion 


DATETIMET 
IfnGetCompletionTime 


Returns the compxei:ion 
time (in context of the 
Class attributes) 


DATETIMET If nGetReplyTime 


Returns the reply time 
(in context of the Class 
attributes) 


BOOL bfnNumListActTaken 


Returns the Number of 
acts present in the 
Queue for the given 
BPTid and WFTid 


BOOL bfnListActTaken 


Returns the list of acts 
present in the Queue for 
the given BPTid and 
WFTid to memory or a 
st)ecified file 



TXSTFADDIHFO 

This class contains additional information for all 
transactions which come via the STF Processor 



IDEN 


ITxid 


IDEN 


1 ciTFProcId 


IDEN 


ISTFTxId 


IDEN 


lUserld 
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TXSTFQUEUE 

This class contains information of all outgoing 
Transactions via the STF Processor. 



Attributes 



IDEN 


ISTFProcessor 


IDEN 


IBPTid 


IDEN 


IWFTid 


NOTIFICATION 


NEvent 


IDEN 


lUserld 


DATETIMET 


IComoletionTime 


DATETIMET 


INotif icationTime 


DATETIMET 


IWhenReaistered 


DATETIMET 


IWhenRead 


IDEN 


ITxId 



Methods : 



TXSTFQUEUE 


The Constructor for this 
class 


BOOL bfnGetEvent 


returns the earliest 
Message Record (When 
Registered has the 
earliest date, and 
WhenRead is 0) from the 
STF Queue for the given 
STF Processor 


BOOL bfnSetReadTime 


Sets the WhenRead 
DateTime field to the 
given Value (In context 
to the Class Attributes) 


BOOL bfnPutEvent 


Inserts a record into 
the STFQueue with the 
given parameters (Sets 
WhenRead to 0 and 
WhenRegistered to the 
Current Time).. 



TXBPBD 

This class contains BP level Bound Data field IDs and 
values related to all BP Instances 
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IDEN 


IBPTid 


IDEN 


IFieldId 


CHAR 


szValueflNIT VAL LENl 



Methods 



TXBPBD 



The constructor of this 
class that depending on 
its first parameter that 
inserts a Record in the 
TXBPBD table for the 
given" BP Transaction 
with BPTid and Fieldid 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the 
field value or returns 
all the Bound Data 
fields (associated with 
the given BP Instance, 
BPTid) . to specified 
file/memory or returns 
the number of Bound 
Data fields associated 
with the given BP 
Instance (BPTid) 



TXWFBD 

This Class contains workflow level Bound Data field IDs 
and values related to all instantiated WFs in BP 
Instances 



IDEN 


IBPTid 


IDEN 


IWFTid 


IDEN 


IFieldId 


CHAR 


szValueflNIT VAL LENT 
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Methods 



The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
TXWFBD table for the given 
WF Instance (WFTid) in the 
specified BP Transaction 
with WFTid , BPTid ,FieldId 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the field 
value or returns the 
number of Bound Data 
fields associated with the 
given WF Instance in the 
specified BP Transaction ( 
BPTid) returns all the 
Bound Data fields 
(associated with the 
given WF Instance in the 
specified BP 
Transaction (BPTid) ) . to 
specified file/memory 



Global Method 



BOOL bfnIsPure 



This method returns TRUE 
if there are no acts 
pending in the TXWFACTS 
Queue for the given WF 
Instance in the specified 
BP Transaction* If there 
are acts in the Queue then 
it returns FALSE. 



Names and Routings Database 



DFSTFPROC 

This class contains information of all STF 
Processors including their IDs ^ names and network 
addresses . 



Attributes 



IDEN 


ISTFProcId 


CHAR 


szSTFProcNametSTFPROCNAME LENl 


CHAR 


SzNetAddress [NETADDRESS LENl 
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Mennoas : — . 

DFSTFPROC 


Txie ConStJTUCuOX xox: uii-i.» 

Class that returns the 
first record from the 
table which matches the 
precixcax.6 xiisv^j-Vi-^ 
Record in the DFSTFPROC 
table for the given STF 
Processor Name and 
NetworK /lacLress xu 
generates the STFProcId 
and returns it 


BOOL bfnGetSTFProcNaine 


Returns the STF 
Processor Name (in 
context of the Class 
attributes) 


BOOL bfnGetNetAddress 


Returns the Network 
Address of the STF 
Processor (in context of 
the Class attributes) 


BOOL bfnDelete 


Deletes the record from 
the DFSTFPROC table 
whose values are in 
context of the class 
attributes . 


BOOL bfnListSTFProcs 


Returns inf ormat ion of 
all STF Processors in a 
set of Structures, 



KRDFORGROLK 

This Class contains the Organization Role ID to 
Organization Role Name mapping. 



IDEN 


lOraRole 


CHAR 


szOraName rORGROLE LENl 
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Methods : 





The Constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFORGROLE 
table containing the 
OrgRole ID and the 
corresoondincr Name 


IDEN IfnGetOrgRole 


Returns the OrgRole ID 
(in context of the Class 
attributes) 


BOOL bfnDelete 


Deletes the record from 
the NRDFORGROLE table 
whose values are in 
context of the class 
attributes . 



NRDFIDENTITY 

This class contains information related to all the 
Identities including their Name, Network Address, Postal 
Address, Phone/Fax and other information. 



IDEN 


lldentitvid 


CHAR 


szIdentitvName [IDENTITY LENl 


CHAR 


szNetAddress [NETADDRESS LEN] 


CHAR 


SzPostalAddress rPOSTALADDRESS LEN] 


CHAR 


szPhone [PHONE LENT 


CHAR 


szFax [PHONE LEN1 


CHAR 


szDeoartment [DEPARTMENT LENl 


CHAR 


szTitle [TITLE LENl 


CHAR 


szLocat ion [LOCATION LENl 


CHAR 


szComment [COMMENT LENl 


BOOL 


bNotifv 


IDEN 


ISTFProcId 
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Methods : 



NRDFIDENTITY 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the 
NRDFIDENTITY table 
containing the 
Identityld, the 
corresponding Identity 
name, and other Identity 
information obtained from 
the qiven parameters 


BOOL bfnDelete 


Deletes the record from 
the NRDFIDENTITY table 
whose values are in 
context of the class 
attributes . 


BOOL bfnGetNotify 


Returns the Notify Status 
(in context of the Class 
attributes) . Notify 
Status will be TRUE if 
the Identity wants a 
Notification of an event. 


IDEN IfnGetSTFProcId 


Returns the STF Processor 
ID (in context of the 
Class attributes) . If the 
Identity is not an STF 
Processor then 0 is 
returned. 


IDEN IfnGetldentityld 


Returns the Identity ID 
(in context of the Class 
attributes) . 


BOOL bf nGetldenNameList 


Returns information of 
all Identities in a set 
of Structures. 



NRDFGROUP 

This class contains all the Groupid to Group Name 
mapping . 

Attributes : 



IDEN 


IGroupId 


CHAR 


SzGrouoName [GROUPNAME LEN] 
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Methods : 



NRDFGROUP 


The Constructor for this 

first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFGROUP 
table containing the 
Groupid, and the 
corresDondinq Group name 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUP table whose 
values are in context of 
the class attributes. 


IDEN IfnGetGroupId 


Returns the Group ID (in 
context of the Class 
attributes) . 



NRDFGROUP AS S I GN 

This class contains all the Groupid to Identityld 
mapping. 

Attributes : 



IDEN 


IGroupId 


IDEN 


lldentitvid 
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Methods : r 

NRDFGROUP ASSIGN 


The Constructor for 
this class that returns 
the first record from 
the table which matches 
the predicate or 
inserts a Record in the 
NRDFGROUP ASSIGN table 
containing the Groupid, 
and the Identity Id 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUPASSIGN 
table whose values are 
in context of the class 
attributes . 


BOOL bfnNurtiListGroup 


Returns the number of 
Groups which contain 
the given Identityld as 
a member 


BOOL bfnListGroup 


Returns information of 
all Groups which 
contain the given 
Identityld as a member, 
to file or memory as 
specified 


BOOL bfnNumListlden 


Returns the number of 
Identities in the 
specified GroupID 


BOOL bfnListlden 


Returns information of 
all Identities which 
belong to the specified 
group, to file or 
memorv as specified 



NRDFGROUPROI.EASSIGN 



IDEN 


IGroupId 


IDEN 


lOraRole 
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Methods : 



NRDFGROUP ROLE AS S I GN 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
record in the NRDFGROUP- 
ROLEASSIGN table 
containing the Groupid, 
and the Organization Role 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUP- ROLE ASSIGN 
table whose values are in 
context of the class 
attributes . 


BOOL t>f nNumListRole 


Returns the number of 
Groups which contain the 
given Organization Role 
as a member 


BOOL bfnListRole 


Returns information of 
all Groups which contain 
the given Organization 
Role as a member, to file 
or memory as specified 


BOOL bf nNurtiListGroup 


Returns the number of 
Organization Roles in the 
specified GroupID 


BOOL bfnListGroup 


Returns information of 
all Organization Roles 
which belong to the 
specified group, to file 
or memory as specified 



NRDFXDEKROLEASSIGK 

This class contains all the Identityld Organization Role 
mapping. 



Attributes : 



IDEN 


lldentitvid 


IDEN 


lOraRole 
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Methods : 

NRDF IDENROIiE AS S IGN 



BOOl* bfnDelete 

BOOL bfnNiimListRole 
BOOL bfnListRole 



BOOL 



bf nNuiriLi s 1 1 dent i t y 



BOOL bfnList Identity 



1 The Constructor for this 
class that returns the i 
first record from the 
I table which matches the 
predicate or inserts a 
Record in the NRDFIDEN- 
I ROLEASSIGN table 
containing the 
Identityld, and the 

1 Orqani7-?9tion Role 

t Deletes the record from 
the NRDFIDEN- ROLEASSIGN] 
I table whose values are 
in context of the class 

: ai-i-ributes ■ ^ 

Returns the number of ^ 
I Org. Roles which contain j 
the given Identity Id as 

I 1-he iden tiitv Id 

Returns information of 
all Org. Roles which 
contain the given 
Identityld as the 
Identity ID, to file or 

tnAmorv a ^ ^specified 

Returns the number of 
Identities with the 

.specif 1* =*^ f^^q- Role 

j Returns information of 
all Identities with the 
specified Org. Role, to 
file or memory as 
oecif ied 



Schedule Database 

This Class contains all the Business Process 
schedule information including time when it has to be 
next initiated and the Recurring period of that BP 

SCBP SCHEDULE 



Attributes : 



TDEN 


IP^PDid 


DATETIMET 


1 TnitTime 


DATETIMET 


IRecPeriod _ 
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Methods : 



SCBPSCHEDULE 


The Constructor for this 
class that inserts a 
Record in the SCBPSCHEDULE 
table for the given STF 

Procp^sor Name and Network 
Address It generates the 
STFProcId and returns it 
or returns the first 
record from the table 
which matches the 
oredicate 


BOOL bfnDelete 


Deletes the record from 
the SCBPSCHEDULE table 
whose values are in 
context of the class 
attributes . 


DATETIMET If nGet InitTime 


Returns the Initiation 
Time of the BP (in context 
of the Class attributes) 


DATETIMET If nGetRecTime 


Returns the Recurring 
period of the BP (in 
context of the Class 
attributes) 


IDEN IfnGetBPDid 


Returns the BP ID (in 

v> X. L. IX w W -L. CI O O 

attributes) 


VOID vfnPut InitTime 


Updates the Initiation 
Time for the BP with the 
specified time (in context 
of the Class attributes) 


BOOL t>f nGe^hFi rcs-t- RP qnhe^rin Ifa 


Xvv^ (_ UX J- X 1 0 ^ XX^ ^ X. O \— oc^ 

scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 


BOOL bfnGetNextBPSchedule 


Returns the next BP 
scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 



AKSAUTH 

This class contains information related to each 
Identities database access privileges. 
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^ W ^ ^ Ai' W> W C ^ ■ 

IDEN 


lldentitvid 


OBJECT TYPE 


Obiectid 


PRIVILEGES 


Privileqe 



BOOL Grant 


Updates the privileges of 
the specified Identity to 
the given set of 
Privileaes 


BOOL Revoke 


Revokes the specified 
privileges from the 
specified Identitv 


BOOL InqpaireAuth 


Returns the Privileges of 
the specified Identitv 



COKFIGINFO 

This Class contains the configuration information of a 
particular installation including the path and file name 
of the Logfile, the interval of the Server polling, the 
path of the Blob file and the maximum number of BP 
instances . 



CHAR 


szLoaFilePathTLOGFILEPATH LEN 1 


CHAR 


szLoaFileNamerLOGFILENAME LEN 1 


INT 


iPollInterval 


CHAR 


SzBlobFilePath[BLOBFILEPATH LEN] 


INT 


iMaxBPInst 


LOGOPTIONS 


LoaOots 


Methods : 



BOOL bfnSetConf iglnfo 



an installation to the 
specified values 



BOOL bfnGetConf iglnfo 



Returns the Configuration 
of the Installation. 



ERRMSG 

Contains the Error code to error Number mapping. 



Attributes 



INT 


iErrNo 


LONG 


lErrCode 



SUBSTITUTE SHEET (RULE 26) 



101 

wo 94/18d20 PCT/US94/01287 



Methods : 



ERRMSG 


The Constructor for this 
Class 


BOOL bfnPutErrNo 


Inserts a record with an 
ErrNo and the 
corresDondinq ErrCode, 


INT ifnGetErrNo 


Gets the ErrNo 
corresponding to the 
specified ErrCode . 



MESSAGEQ 

This Class contains the Message Queue which is used by 
the components of the Server for internal communication. 

Attributes : 



PROCESS 


Sender 


PROCESS 


Recipient 


MESSAGE 


Messaae 


LONG 


IP a rami 


LONG 


lParam2 


LONG 


IParamS 


LONG 


lParam4 


CHAR 


szParamfPARAM LEN] 


DATETIMET 


IWhenPosted 



Methods 



MESSAGEQ 


The Constructor for this 
class 


BOOL bf nPostMessage 


Puts the given message 
into the Message Queue 
with the specified 
Sender and Recipient 
fields 


BOOL bfnGetMessage 


Gets the first message 
marked to the specified 
recipient from the 
Messaae Queue. 


BOOL bf nFlushMessage 


Deletes all messages . 
from the Messaae Queue. 



Administration and Configuration Database 



Server Management 

ServerMgmt 

Attributes 

IServerld identifier 
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szServerName 
Methods 

StartServer 
StopServer 



s t: r in g [ s z_s e r ve r n ame ] 



/* The method 
StopServer should 
find all BPs that 
have the server as 
Home & issue 
warning to the 
current users */ 



Login 
Logout 

ListLoginActvities 
User Maintenance 



UserMalnt: 

Attributes 

LoginName 
Password 
Methods 

AddNewUser 
RemoveUser 
ModifyUserInf o 



ref (Identity) 

string 

string 



or ref (Group) 



Aut:liorlzat:i.on Halniienance 



Object 

Attributes 

Qbjegtid 
Ob jectType 

AutliMalnt: 

Attributes 
User 

Objectid 
Privilege 
GrantOption 
Methods 

Grant 
Revoke 



ref (BP) or ref (WF) or 

ref (STFProcessor) 

Ob jecttype 



ref (User) 
ref (Object) 
privilege 
bool 



InquireAuthorization 

Business Process Maint:enance 



BPMalnt 

Methods 

AbortBP 
• DeleteBP 
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SuspendBP 
ResumeBP 
ArchiveBP 
ListAvailBPs 
List Act iveBPs 
DeleteBPDef inition 



Workflow Malntienance 



WFMaint 

Methods 

ListAllWF 



STF Processor Maintenance 



STFMaint 

Methods 

RegisterSTFProc 
DeregisterSTFProc 



Backup and Restore 



Backup 

Attributes 
RPTd 



SackupPate 

BackupTime 



string 



time 
time 
enum 



/* Business 
Process name is 
NULL, implies 
backup / restore 
entire DB */ 



Methods 

Backup 
Restore 



Database Management 

DBMgmt 

Methods 

CheckDatabase 
IndexDatabase 
ReorganizeDat abase 

Configuration 

Conflg 

Attributes 

MaxUserCount int 
MaxOpenBPs int 
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Version string 

Methods 

SetConf iguration 
GetConf iguration 



STF Queue Da'tabase 

STF Additional Information Class 

The server as a service stores additional fields 
required by STF processors. The STF Processor Id, the STF 
Transaction Id and the User Id are stored. 

TxSTFAddlInf o 

The STF Queue database is implemented through two 
classes TXSTFADDINFO and TXSTFQUEUE which are desribed 
with other classes of the transaction database. 

B . WORKFI.OW APIs 

Workflow ^Transactions API 

This section describes the functions performed by 
the transactions API. A description of each function is 
set forth followed by the syntax of a call to the 
function, with specification of each parameter passed to 
the function. From this information, a suitable code 
segment can be written to implement the function. 

AHSTINITBP 

Description 

This function creates a new instance of a 
previously defined Business Process (BP) . The BP Name is 
passed and a BP Id is returned. This Id will be required 
for all subsequent calls to this API. This call also 
activates the Primary workflow. To create this instance 
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of the Business Process the Name specified for the 
IdentityName must be authorized. Optionally the mapping 
of Organization Role Names to Identity Names may be 
provided. This . overrides the default mapping (if any). 



Syntax 

VOID FAR PASCAL AWSTINITBP (STRING szBPName, 

STRING szInitiatorName, STRING 
sz Customer Name, STRING szPerf ormerName, 
DATETIMESTRING s zComplet ionDate^ 
DATETIMESTRING szResponseDate, 
DATETIMESTRING szInitiateDate, 
INT iCount, LP0RG2ID IpOIPtr, 
LPIDEN IpBPTid, STRING szCWFName, 
LPERRCODE IpError) 
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Name 


Type 


Descrlptixon 


szBPName 


STRING 


Bu s ine s s P r oce s s 
Name. This BP must 
have previously 
oeen ae i. meti diiu 
the name known to 


szInitiatorName 


STRING 


Name of the person 

initiating the 
business process . 
The identity must 

authorized to 
activate the 
business orocess. 


s z C u s t ome r Name 




Lid L. Utllw X. XV,<lwliL»^l.>J^ 

Name . 


s zP e r forme rName 


STRING 


Performer Identity 
Name . 


szCompletionDate 


DATETIMESTRING 


The date by which 
the Primary 
workflow must be 
completed . 


s zRe sponseDat e 


DATETIMESTRING 


The date by which 
negotiation must be 
complete . 


szInitiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 

T n ^ +" "i si" #ari Viv thf* 

^± 1 J« J- ex. L_ w \Ji Jf IrXX^ 

server. If this 
date is not 
specified then the 
Business Process is 
initiated 
immediatelv . 


iCount 


INT 


The number of 
Organization Role 
to Identity mapping 
entities . 
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IpOIPtr 


LPORG2ID 


Pointer to an array 
of structures which 
contains the 
mapping of 
Organization Role 
to Identities. In 
the structure 
ORG2ID, the 
application must 
set the GLOBAL or 
LOCAL flag to 
identify whether 
the ORG2ID 
overriding is at BP 
level or at WF 
level. 


IpBPTid 


LPIDEN 


returns BPTid. 


szCWFName 


STRING 


returns the name of 
Primary Workflow. 


loError 


LPERRCODE 


Error Code. 



Ret:urn Value 

The function returns the Business Process Instance 
Id, BPTid and Primary WF name, szCWFName. 



AWSTIKITWF 

Description 

The business process this workflow belongs to must 
have been instantiated. The application must supply the 
Business Processes' Business Process Transaction Id. The 
Identity Names of the Customer and Performer are optional 
if defaults have been specified. The dates for completion 
and reply are optional. If these dates are NULL values, 
the defaults specified by the workflow's definition (if 
any) will be used. The Initiate date is optionally 
specified only for the Primary workflow to initiate it at 
a later date. Optionally the mapping of -Organization 
Roles to Identity Names may be passed. These override the 
default mapping if any. 
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VOID FAR PASCAL AWSTINITWF (BPTID IBPTid, STRING szWFName, 
STRING szInitiatorName, STRING 
szCustomerName, STRING szPerf oinnerName, 
DATETIMESTRING szCompletionDate, 
DATETIMESTRING szResponseDate, 
DATETIMESTRING szInitiateDate, 
INT iCount, LPORG2ID IpOIPtr, 
LPERRCODE IpError) 
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Parameters 



Hame 


Tvpe 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFKame 


STRING 


The name of the workflow 
to be initiated. The 
primary workflow can be 
initiated prior to an 
initiation date specified 
in the AWSINITBP function, 
or a previously specified 
initiation date changed 
using this function by 
specifying the name of the 
primary workflow. If the 
specified workflow is not 
the primary workflow, then 
the Business Process this 
workflow belongs to must 
have already been 
initiated. 


W^Xli^ L.JL O- w Xi n 1 LLw 


STRING 


The Identity Name of the 
person initiating the 
workflow. The workflow 
will be initiated only if 
the identity has the 
authorization . 


s z Cu s t: ome r K ame 


STRING 


The Identity Name of the 
person who is the Customer 
for this workflow. 


szPerf ormerNaine 


STRING 


The Identity Name of the 
person, who is the 
Performer for this 
workflow. 


szCompletionDate 


DATETIMESTRING 


The date by which this 
workflow must be 
comolet ed . 


szResponseDat.e 


DATETIMESTRING 


The date by which 
negotiation must be 
comolete . 


szInltiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 
initiated by the server. 
If this date is not 
specified then the 
workflow is initiated 
immediately. This date can 
be specified only for the 
Primary workflow. 


iCount 


INT 


The number of Organization 
Role to Identity mapping 
entities . 
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IpOIPtr 


LPORG2ID 


Pointer to an array of 
structures which contains 
a mapping of Organization 
Role to Identity Names. 


loError 


LPERRCODE 


Error Code . 



Re'turn Value 

None 

AWSTACTINWF 

Description 

This function instructs the workflow server to 
perform the act specified in the specified workflow of a 
specific business process. The Business Process 
Transaction ID and Workflow Name must be specified. The 
identity performing the act must be specified. The server 
records the act to be taken and updates the workflow. The 
server may take an unspecified time to take the act 
because of the queuing of the acts to be taken. If the 
client application issues a query when the act is 
pending, the application will receive status values which 
are not updated and this will be indicated by CLEAR or 
PENDING flag of the query APIs. 

Syn1:ax 

VOID FAR PASCAL AWSTACTINWF (STRING szSTFProcName, 

STRING szSTFTxName, STRING szSTFUserName , 
BPTID IBPTid, STRING szWFName, ACT Act, 
DATETIMESTRING s zComplet ionDate, 
DATETIMESTRING szReplyDate, STRING 
szParticipantName, LPIDEN IpTxId, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szSTFProcName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 


szSTFTxNaxne 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 


s zSTFUserName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFName 


STRING 


The Transaction Id of the 
workflow in which to take 
the act. 


Act 


ACT 


The act to take, e.g.. 
Request, Aoree, etc. 


3 zCompletionDate 


DATETIMESTRING 


Completion date can be 
optionally specified 
whenever permitted or 
recommended has to be 
specified for all Customer 
/ Performer Counter Acts. 


IReplyDate 


DATETIMESTRING 


Reply date has to be 
specified for the 
following acts: Customer / 
Performer Counters, 
Declare Coxr^sletion and 
Declare dissatisfaction. 


s zXnitiatorName 


STRING 


Identity of the person 
reouesting the act. 


IpTxid 


LPIDEN 


Uniqpie Transaction Id 
returned by the API. This 
Id is used to inquire 
about the status of taking 
the Act. 


IpError 


LPERRCODE 


Error code returned by the 
server . 
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Retiurn Value 

The unique transaction Id generated by the server 
is returned. The application calling the transaction API, 
AWSTACTINWF can use this Id to inquire about the status 
of the Act. The API call to be used is 
AWSTACTSTATUSQUERY . 

. AWSTACTSTATaSQUERY 

Description 

This function gets the status of the Act requested 
by the AWEA via the transaction API call AWSTACTINWF. The 
Status indicates whether the act was taken successfully 
or an error occurred. In case of an error, a diagnostic 
error code will be returned. 

Syntax 

VOID FAR PASCAL AWSTACTSTATUSQUERY (IDEN ITxId^ 

STRING szSTFProcNamef STRING szSTFTxName , 
STRING szSTFUserName, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


iTxid 


IDEN 


Unique Transaction Id 
returned by the API - 
AWSTACTINWF. This Id is 
to be used to identify 
the Act being inquired 
about - 


szSTFProcName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ignore this parameter. 


szSTFTxName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ianore this parameter. 


s zSTFUserName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ianore this parameter. 


IpError 


LPERRCODE 


Error code returned by 
the server. This 
indicates whether the 
Act was taken 
successfully or an 
error occurred. 



Return Value 

In case the call is made by a workflow application 
via an STF Processor, then the szSTFProcName, szSTFTxName 
and the szUserName are returned along with Error (which 
indicates the status of the Act) . If the call is made by 
an application directly, then the Application needs to 
check only the error code. 
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AWSTBXNDAPPDATA 

Description 

Binds data* to a business process or workflow 
instance. Application data can be attached or bound to a 
business process or workflow. Later this information can 
be retrieved. The data field name and data value are 
supplied. Data type is specified at definition time. Any 
number of data items may be bound. When data is bound to 
the business process, the workflow name is specified by 
NULL. 

Syntax 

VOID FAR PASCAL AWSTBINDAPPDATA (BPTID IBPTidr STRING 
szWFName, STRING szParticipantName, 
INT iFields, 

LPTXBDFIELDSTRUCT IpTxBDFieldStructPtr , 
LPERRCODE IpError) 
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Parameters 



Kame 


Type 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the 
workflow in which to 
bind the data . The 
workflow name is 
specified as NULL if 
data is to be bound 
to the business 
process. 


szParticipantName 


STRING 


Identity of the 
person requesting 
binding of 
application data. 


iFields 


INT 


The number of fields 
to bind with the 
workflow 


IpTxBDFieldStructPtr 


LPTXBDFIEL 
DSTRUCT 


A pointer to a array 
of structures 
containing the field 
name, type, size and 
the field value . The 
structure 
BDFIELDSTRUCT 
contains an element 
of type ATTRIBUTES. 
This parameter will 
be ignored by the 
API. 


IpError 


LPERRCODE 


Error code returned 
by the server. 



Return Value 

Data is bound to the workflow. 



AWSTGETAPPDATA 

Descri.pt Ion 

A set of data fields and values are returned 
corresponding to the data fields bound to a workflow 
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instance. The number of fields aiid for each field the 
field name, type and its value are returned. 



Syntax 

VOID FAR PASCAL AWSTGETAPPDATA (BPTID IBPTid, STRING 
szWFName, STRING szFormName, 
WFROLE WFRole, STRING szPart icipantName , 
LPINT IpiFieldsPtr, BOOL bFileOrMemory, 
LPADFIELDSTRUCT IpADFieldSt ructPtr , 
STRING szFileName, LPERRCODE IpError) 
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Parameters 



Name 


Type 


1 Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


s zWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data. The workflow 
name should be set to 
"GLOBALBPDATA" to 
retrieve business process 
bound data. 


szFormHame 


STRING 


The form name is 
returned. This was stored 
along with the bound 
data . 


WFRole 


WFROLE 


The WFRole of the 
participant. This need 
only be specified if the 
participant has more than 
one role in the workflow. 


szPart.icipantName 


STRING 


The name of the person or 
identity requesting 
Application Data 
associated with the 
workflow . 


IpiFieldsPtr 


LP INT 


The number of bound data 
field to be retrieved. 


bFileOrMemory 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API. 


IpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an array of 
structures, where the 
field name, type and the 
field values are 
returned. The structure 
ADFIELDSTRUCT contains an 
element of type 
ATTRIBUTES. This 
parameter is to be 
ignored by the 
Application. The API 
returns the list of 
attributes if 
bFileOrMemory is 
ITS_MEMORy . Application 
Data fields defined as 
HIDDEN for the particular 
WFRole, requesting 
Participant, and current 
workflow state are 
returned as NULL strinos. 



SUBSTITUTE SHEET (RULE 26) 



wo 94/18620 



118 



PCT/US94/01287 



szFileName 


STRING 


File name where the API 
should deposit the 
results of the call if 
the flag bFileOrMemory is 
ITS FILE. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

IpiFields contains the number of fields retrieved. 
BDFieldStruct contains the field name^ field type and 
field value for all the fields retrieved. 

AWSTGETAPPDATAFXELDATTRIBUTES 
Description 

This functions returns the list of application data 
field names arid their attributes for a specified act or 
state for a specific workflow of a Business Process. The 
attributes returned are Read-Only, Editable and Hidden. 
These attributes are Boolean. 

Syntax 

VOID FAR PASCAL AWSTGETAPPDATAFIELDATTRIBUTES (BPTID IBPTid, STRING 
szWFName, BOOL bActORState, ACTSTATE ActOrState, 
-STRING szFormName, STRING szParticipantName, 
WFROLE WFRole, LPINT IpiFields, 

LPFLDNAMEATTR IpFldNameAttr , BOOL bFileOrMemory, 
STRING szFileName, LPERRCODE IpError) 
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Parameters 






Name 


Tvpe 


Description 


IBPTid 


BPTID 


Business Process 

T ran f t" i nn Tri 

The Id of a 
previously 
instantiated BP. 


szWFName 


STRING 


The Transaction 

J. u O I. u 116 

workflow from 
which to 
retrieve, field 
attributes of 
the bound data. 


fciAe t OR S a 1- 


BOOL 


Boolean flag to 
indicate the 
type of the 
ACTS TATE 
parameter. 


ActOrState 


ACT STATE 


The field 
attributes 
specified for 
this act or 
state are 
returned. 


szFonnName 


STRING 


The form name is 
returned. This 
was stored along 
wiu>n une oounu 
data . 


3 zP a rt i c i pan tName 


STRING 


The name of the 
person or 
identity 

requesting Field 
Attributes of 
the Application 
Data associated 
with the 
workflow . 


WFRoIe 


WFROLE 


The workflow 
role of the 
identity.. 


IpiFieldsPtr 


LPINT 


The number of 
bound data 
fields for which 
the attributes 
are returned. 


IpWFMomentBDField 


LP WFMOMENTBDF I E - LD S TRUCT 


A pointer to a 
array of 
structures 
containing the 
field name and 
field 

attributes . 
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bF i 1 eOrMemo ry 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt 
of data from the 
API. 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


IpError 


LPERRCODE 


Error code 
returned by the 
server. 



Return Value 

IpiFieldPtr is updated with the number of fields for 
which the field attribute is returned. 
FieldStruct contains the field attributes for the 
specified act. 

AWSTSTATUS 

Description 

This function returns status of the workflow 
instance for a specific participant. The state of the 
workflow, the current incompletions with the dates, etc. 
Information is returned in the STATUS structure. 

Syntax 

VOID FAR PASCAL AWSTSTATUS (BPT ID IBPTid, STRING SzWFName, 
STRING szParticipantName, WFROLE WFRole^ 
LPINT IpCurrentr LPSTATUS IpStatusPtr, 
LPERRCODE IpError) 
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Parameters 






Name 


Type 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP . 


szWFNante 


STRING 


The workflow name whose 
status is desired 


s zPa rt i ci pan t Name 


STRING 


The status of the workflow 
is returned with respect 
to this Identity. 


WFROie 


We KWLtTj 


participant. This field 
is only required if the 
participant is both 
customer and performer. 


IpCurrent 


LPINT 


The current status - CLEAR 
i.e. • f no A.C uS xn une 
queue waiting to be . 
serviced or PENDING i.e.., 
some acts are in the queue 
vet to be serviced. 


IpStatusPtr 


LP STATUS 


The STATUS structure 
contains the Status String 
and various Coir^letion and 
Reply dates. These dates 
depend on the role of the 
Identity. 


IpError 


LPERRCODE 


Error code returned by the 
server. 
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Re^turn Value 

Structure Status contains the status of the specified 
workflow. 

Element Status . StatusString contains the string 

describing the current state of the workflow. 

The following Completion and Reply dates are returned: 



Customer 


Performer 


Comoletion reouested 


Completion due 


Reulv due to Performer 


Replv due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reply due by Performer 


Reolv due bv Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 



AWSTAVAX1.A&LEACTS 

Description 

Returns a structure that contains the list of 
available acts in the specified workflow for the role 
that the participant has in the workflow. 

Syntax 

VOID FAR PASCAL AWSTAVAILABLEACTS (BPTID IBPTid, 
STRING szWFName, WFROLE WFRole, 
STRING szParticipantName, BOOL cDialog, 
BOOL bFileOrMemory, LP INT IpiCountPtr, 
STRING szFileName, LPACTINFO ActPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 1 Description 


IBPTid 


BPTID 


Business Process Transaction 
Id. The Id of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the workflow whose 
status is desired 


WFRole 


WFROLE 


The workflow role of the 
identity. This field is only 
required if the participant is 
both customer and performer in 
the workflow . 




STRING 


The name of the person or 
identity for which the list of 
available acts is returned. 


cDialo^ 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to the 
user to select a specific act. 
In this case, the list of 
available actions returned by 
this function will be the 
selected one . 

If cDialog is FALSE, then no 
dialog box is presented and all 
available acts are returned. 


bF i leO rMemo ry 


BOOL 


Flag to indicate File or Memory 
mode of receipt of data from 
the API. 


IpiCountPt r 


LPINT 


Number of acts returned in the 
structure 


szFileName 


STRING 


File name where the API should 
deposit the results of the call 
if the flag bFileOrMemory is 
ITS FILE. 


IpActPtr 


LP ACT INFO 


A pointer to an array of 
structures which contains the 
list of acts, i.e.. Act Names, 
user-defined names for the 
acts . 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

IpiCountPtr is updated with the number of possible acts 
the Identity can take in the current workflow. 
The structure array passed is filled with the Acts Names 
and user-defined names . 
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Description 

This function returns the list of workflows that 
the named person or identity has as a specific 
Organization Role. The list of workflows is selected from 
the set of instantiated business processes that have the 
same business process name. The workflow status for each 
workflow is returned. 

Syntax 

VOID FAR PASCAL AWSTQUERYWF (STRING szPart icipantName, 
STRING szOrgRole, WFROLE WFRole, 
STRING szBPName, 
DATETIMESTRING szStartDate, 
DATETIMESTRING szEndDate, BOOL bPending, 
BOOL cDialog, BOOL bFileOrMemory, 
LPINT IpiCount, STRING szFileName, 
LPWFSNAPSHOT IpWFSnapShot , 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


1 


szParticipantName 


STRING 


The participant for which 
the list of workflows is 
returned. 




szOrgRole 


STRING 


The organization role of 
the participant. Only 
worKZXOWs wnau nave unxs 
specific OrgRole are 
selected, if OrgRole is 
SF>ecified as NULL then all 
workflows are selected 
regardless of the role. 




WFROle 


WFROLE 


The workflow role of the 

only required if the 
participant is both 
customer and performer or 
is an observer in the 
workflow . 




s zBPName 


STRING 


The workflows are selected 
only for the specified 
BPName. If BPName is NULL, 
then relevant workflows are 
selected regardless of the 
business process. 




szStartDate, 


DATETIMESTRING 


These dates specify a date 




szEndDate 




range of due dates for 
which the list is 
constructed. If StartDate 
is NULL then the list 
includes all relevant 
workflows . 




bPending 


BOOL 


If Pending is TRUE then the 
list workflows includes 
only those workflows where 
action is pending. The 
workflows which needs to be 
initiated are also 
included. Otherwise it 
includes workflows where 
action is not oendina. 




cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to 
the user to select a 
specific workflow. In this 
case, the list of workflows 
returned by this function 
will be the selected one. 
If cDialog is FALSE, then 
no dialog box is presented 
and all available workflows 
are returned. 
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b F i 1 eO rMemo iry 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API. 


szFileName 


STRING 


File name where the API 
should deposit the results 

bFileOrMemorv is ITS FILE. 


IplCount. 


LP INT 


Returns the count of 
workflows selected. 


IpWFSnapShot 


LPWFSNAPSHOT 


Pointer to a list of 
selected workflows. Each 
workflow includes Business 
Process name & Id, Workflow 
name, Customer, Performer, 
Completion and Reply Dates, 
Status and Form name 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Keburn Value 

IpiCount, the number of workflows in the list. 

IpWFList points to a list of WFLIST structures. 

The structure returns several dates depending on role o 



the Identity. 



Custonier 


Performer 


Completion recruested 


Completion due 


Reolv due to Performer 


Reply due to Customer 


Completion due by Performer 


Completion requested by 
Customer 


Reply due bv Performer 


Reply due bv Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned 



AWSTAVAIIiABLEBP 

Descrlp'bion 

This function returns a list of BP Names • 

Syntax 
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VOID FAR PASCAL AWST A VAIL ABLE BP (STRING szPart icipantName ^ 
BOOL cDialog, INT iBPStatus, 
LP INT IpiCount, BOOL bFileOrMemory, 
LPBPINFO IpBPInfo, STRING szFileName, 
LPERRCODE IpError) 



Parameters 



N&zne 


Type 


Description 


szParticipantName 


STRING 


The participant for which the 
list of BPs is returned. 


cDialog 


BCX>L 


If CDialog is TRUE, then a 
dialog box is presented to the 
user to select a specific BP. 
In this case, the list of BPs 
returned by this function will 
be the selected one. 
If cDialog is FALSE, then no 
dialog box is presented and 
all available BPs are 
returned. 


iBPStatus 


INT 


Indicate the iBPStatus 
required. ACTIVE_BPS select 
only active BPs. The flag 
INACTIVE selects all BPs in 
the definition database. 


IpiCount 


LP I NT 


The number of BPs returned. 


bF i 1 eO rMemo ry 


BOOL 


Flag to indicate file or 
memory mode of receipt of data 
from the API . 


IpBPInfo 


LPBPINFO 


A pointer to an array of 
BPINFO structures that contain 
the business process name and 
Id. 


szFileName 


STRING 


File name where the API should 
deposit the results of the 
call if the flag bFileOrMemory 
is ITS FILE. 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

IpiCount, the number of workflows in the list. 
BPListPtr points to a linked list of BPINFO structures 
that contain the Business Process Name & Id. 



AWSTACTHI STORY 
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De5crlpt.ion 

This call returns a list of Acts taken in the 
specified business process for a specific workflow. If 
workflow name is NULL, then the history of the entire 
business process, i.e., list of all acts taken of all 
workflows is returned. 



Synl^ax 

VOID FAR PASCAL AWSTACTHISTORY (STRING szPart icipantName, 
BPTID IBPTid, STRING SzWFName, 
LP INT IpiCount, BOOL bFileOrMemory, 
STRING szFileName, 
LPACTSTAKENLIST IpActsList, 
LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


szParticipantName 


STRING 


The participant for 
which the list of 
Acts taken is 
returned . 


IBPTid 


BPTID 


Business Process id 


szWFName 


STRING 


The workflow name 
for which the list 
of acts taken is 
returned. If no 
name is specified, 

null, then the act 
history for the 
entire Business 

returned. 


IpiCount 


LP INT 


Pointer to an 
integer. The 
function returns 
number of Acts 
returned. 


bF i 1 eOrMemory 


BOOL 


Flag to indicate 
file or memory mode 
of receipt of data 
from the API . 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


IpActsList 


LPACTSTAKENLIST 


Pointer to 
ACTSTAKENLIST 


IpError 


LPERRCODE 


Error code returned 
bv the server . 



Return Value 

IpiCount, the number of. Acts in the list. 

IpActsList points to a list of ACTSTAKEN structures that 
contain Business Process Name & id. Workflow Name & id. 
Act Name & id, Act Date and the ParticipantName who took 
the act . 
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AWSTGETNSTRIKG 



Description 

The notification string for the event is retrieved. 
If no such string is present for the workflow then 
default string associated with the Business Process is 
retrieved. If no default string is present then a null 
string is returned. 

Syntax 



VOID FAR PASCAL AWSTGETNSTRING (BPTID iBPTid, STRING 
szWFName, EVENT Notif icationEvent , 
STRING szNotif icationString, 
LPERRCODE IpError) 

Parameters 



Kame 


Tvpe 


Description 


IBPTid 


BPTID 


Business Process id 


szWFName 


STRING 


Workflow name . 


Not i f i cat i onE ven t 


EVENT 


This parameter 
specifies the event 


szNotif icationString 


STRING 


The notification 
strina returned . 


IpError 


LPERRCODE 


Error code returned 
by the server . 



Notification Events 


Event 


Notification Type 


Performer Response past due 


FollOW-UD 


Performer Completion past due 


Follow-up 


Performer Completion cominq due 


Reminder 


Customer Response oast due 


Follow-uD 


Act taken 


Act 



Return Value 

szNotif icationString will contain the notification string 



AWSTPOLLSTFQUEUE 



Description 
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This call returns the notification event to the STF 
Processor. If the notification event is "Act Taken", then 
the parameter IpTxId will contain the transaction Id of 
the Act . 

Syn^aac 

VOID FAR PASCAL AWSTPOLLSTFQUEUE (STRING 

szSTFProcessorName, LPIDEN IpBPTid, 
STRING szWFName, LPINT IpEvent, 
LPIDEN IpTxId, STRING szPart icipantName, 
DATETIMESTRING s zComplet ionTime , 
DATETIMESTRING szNot if icat ionTime, 
LPERRCODE IpError) 
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Kama 


Type 


Descr Ipi: Ion 


szSTFProcessorName 


STRING 


STF Processor Name 


IpBPTid 


LPIDEN 


BPTid of the BP 
instance which has 
some notification 
to be sent to the 
application . 


szWFName 


STRING 


WFName of the WF 
instance 


IpEvent 


LP INT 


The Event Id is 
returned here . 


IpTxId • 


LPIDEN 


Txld of the Act if 
Event is "Act 
Taken" 


szParticipantName 


STRING 


The participant's 
name is returned. 


szCompletionTime 


DATETIMESTRING 


Completion date & 
time is returned. 
This is the date 
and time when the 
event was due. For 
example, the 
instance when 
Performer Response 
is due . 


s zNot if icat ionTime 


DATETIMESTRING 


Notification date & 
time is returned . 
This is the instant 
when this 
notification was 
placed in the STF 
oueue . 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Hot 1£1 cab Ion Events 


Event 


Notification Type 


Performer Response 
past due 


Follow-up 


Performer Completion 
past due 


Follow-up 


Performer Completion 
coraina due 


Reminder 


Customer Response past 
due 


Follow-up 


Act taken 


Act 



Return Value 
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AWSTNUMAVAZLABLEACTS 

Description 

Returns number of available acts in the specified 
workflow for the role that the identity has in the 
workflow. 

Syntax 

VOID FAR PASCAL AWSTNUMAVAILABLEACTS (BPTID IBPTid, 
STRING szWFName, WFROLE WFRole, 
STRING szParticipantName, 
LPINT IpiCountPtr, LPERRCODE IpError) 



Parameters 





Tvpe 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP. 


szWFNarae 


STRING 


The name o f the 
workflow whose status 
is desired 


WFRole 


WFROLE 


The workflow role of 
the identity. 


szParticipantName 


STRING 


The participant for 
which the list of 
available acts is 
returned. 


IpiCountPtr 


LP INT 


Number of acts 
returned in the 
structure 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Return Value 

IpiCount is updated with the number of possible acts the 
Identity can take in the current workflow. 
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AWSTGETKITMAPFDATA 
Description 

Number of data fields are returned corresponding to 
the data fields bound to a workflow instance - 

Syntax 

VOID FAR PASCAL AWSTGETNUMAPPDATA (BPTID IBPTid, 

.STRING szWFTName, WFROLE WFRole, STRING 
szParticipantName, LPINT IpiFieldsPtr, 
LPERRCODE IpError) 



Parametegs 



Name 


Type 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id 
of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data . The 
transaction id should be 
null to retrieve 
business process bound 
data . 


WFRole 


WFROLE 


The WFRole of the 
Identity 


szParticipantName 


STRING 


The name of the person 
or identity requesting 
Application Data 
associated with the 
workflow . 


IpiFieldsPtr 


LPINT 


The number of bound data 
field retrieved . 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

IpiFields contains the number of fields retrieved. 
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AWSTHOMAVAILABLEBP 

Descrip1:lon 

This function returns the number of BPs that 
satisfy a query. 

Syntax 

VOID FAR PASCAL 

AWSTNUMAVAILABLEBP (STRING szParticipantNa 
me, INT iBPStatus, LPINT IpiCount, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szParticipantName 


STRING 


The participant for 
which the list of BPs is 
returned. 


iBPStatus 


INT 


Indicate the iBPStatus 
required. ACTIVE_BPS 
only can be selected or 
all BPS in the 
definition could be 
selected. 


IpiCount 


LPINT 


The number of BPs 
returned. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

IpiCount,. the number of workflows in the list. 
AWS TNUMACTHI S TORY 

Description 

This call returns the number of Acts taken in the 
specified business process for a specific workflow. If 
workflow Id is NULL, then the history of the entire 
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business process, i.e., the number of all acts taken of 
all workflows is returned. 

Syntax 

VOID FAR PASCAL AWSTNUMAC THIS TORY (STRING 

szParticipantName, BPTID iBPTid, STRING 
szWFName, LP INT IpiCount, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szParticipantName 


STRING 


The participant for 
which the list of 
Acts taken is 
returned . 


IBPTid 


BPTID 


Business Process id 


szWFName 


STRING 


The workflow name 
for which the list 
of acts taken is 
returned. If no name 
is specified, i.e., 
the string is null, 
then the act history 
for the entire 
Business Process is 
returned. 


IpiCount 


LP INT 


Pointer to an 
integer. The 
function returns 
numbe r of Act s 
returned . 


IpError 


LPERRCODE 


Error code returned 
bv the server . 



Return Value 

IpiCount, the number of Acts in the list. 

AWS TNUMQUERY WF 

Description 
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This function returns number of workflows that a 
participant is a member of as a specific Organization 
Role . 



Syntax 

VOID F7^ PASCAL AWSTNUMQUERYWF (STRING szParticipantName, 
STRING szOrgRole, STRING szBPName, 
STRING szStartDate, STRING szEndDate, 
BOOL bPending, LPINT IpiCount, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


s zPart icipantName 


STRING 


The participant for which the 
list of workflows is 
returned. 


szOrgRole 


STRING 


The organization role of the 
participants. Only workflows 
that have this specific 
OrgRole are selected. If 
OrgRole is specified as NULL 
then all workflows are 
selected regardless of the 
role 


szBPName 


STRING 


The workflows are selected 
only for the specified 
BPNaroe. If BPName is NULL, 
then relevant workflows are 
selected regardless of the 
business process. 


szStartDate 


DATETIMESTRING 


StartDate for Query list. 


szEndDatie 


D ATE T IME S TRI NG 


End Date for query- list. 
These dates specify a date 
range of due dates for which 
the list is constructed. If 
StartDate is NULL then the 
list includes all relevant 
workflows . 


bPending 


BOOL 


If Pending is TRUE then the 
list workflows includes only 
those workflows where action 
is pending. The workflows 
which needs to be initiated 
are also included. .Otherwise 
it includes workflows where 
action is not pendina. 


IpiCount 


LPINT 


Returns the count of 
workflows selected. 


IpWFSnapShot 


LPWF SNAP SHOT 


Pointer to a list of selected 
workflows. Each workflow 
includes Business Process 
name & Id, Workflow name & 
Id, Customerld, Performerld, 
Completion and Reply Dates, 
Status and form name 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

IpiCount, the number of workflows in the list. 
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Customer 


Performer 


Completion reauested 


Completion due 


Reply due to Performer 


Reply due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reolv due bv Performer 


Reply due by Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 

AWSTSETCOS 

Descript:ion 

This function specifies the Conditions of 
Satisfaction (COS) associated with a workflow of a 
Business Process Instance. The COS is inserted as a 
series of memory blocks. This function requires the 
Business Process context and workflow to be setup before 
execution . 

Syntax 

VOID FAR PASCAL AWSTSETCOS (IDEN IBPTid, STRING szWFName, 
LPMEM IpCOS, LPINT IpiMemBlockSi ze , 
INT iPositionNotify, LPERRORCODE IpError) 
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Name 


Tvpe 


Descriptiion 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id 
of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the 
workflow. 


IpCOS 


LPMEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


IpiMemBlockSize 


LP INT 


Memory allocated for 
storina COS in bvtes. 


iPos it ionNot i f y 


INT 


This variable identifies 
the first COS buffer, 
subsequent COS buffers 
and the last one . It 
should be set to 0 to 
identify first buffer, 1 
to identify subsequent 
buffers . 


luError 


LPERRORCODE 


Error code rerurned. 



Return Value 



AWSTGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks. The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 
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VOID FAR PASCAL AWSTGETCOS ( IDEN iBPTid, STRING szWFNaine, 

LPMEM IpCOS, LPINT IpiMemBlocJcSize, LPLONG 
IpOffset, LPERRORCODE IpError) 



Parameters 



Kama 


Type 


Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP . 


szWFName 


STRING 


The name of the workflow. 


IpCOS 


LPMEM 


Pointer to a memory chunk 
which stores COS (BLOB) . 


IpiMemBlockSize 


LPINT 


Memory allocated for 
storina COS. in. bytes. 


IpOffset 


LPLONG 


Initially, the caller 
must set this to zero. 
Each block transfer 
changes the value 
contained in this 
variable and the caller 
can only check the value 
returned here. This will 
be negative if end is 
reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 



Description 

This function returns the workflow transaction id of a 
workflow in a business process instance. 

Syntax 

VOID FAR PASCAL AWSTGETWFTID (IDEN IBPTid, STRING szWFName, 
LPIDEN IpWFTid, LPERRORCODE IpError) 
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Name 


Type 


Description 


IBPTid 


BPTID 


Business Process Transaction 
Id, The Id of a previously 
instantiated BP. 


szWFName 


STRING 


The workflow name for which the 
transaction id is reouired 


IpWFTid 


LPIDEN 


The Transaction Id of the 
workflow is returned. 


iDError 


LPERRCODE 


Error code returned . 



Return Value 



Workflow Definitions API 
AWSDBEGINBP 

Description 

This call creates a new Business Process. The 
Business Process name is specified as a parameter. The 
Business Process name should be unique. If a Business 
Process with the same name is present, the current 
definition is overwritten as a new version. This takes 
place only if there are no active instances of the 
current business processes. The version number. is 
maintained internally by the server. 

The AWSDBeginBP should be the first call when 
defining a business process and no other AWSDBeginBP call 
should be in progress. Every AWSDBeginBP has to be closed 
by a AWSDEndBP call. The AWSDEndBP should be the last 
call and ends the definition of a business process. 

AWSDBeginBP sets up a context for the business 
process and all subsequent calls require this context. 
The AWSDEndBP closes this context . 

Syntax 
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VOID FAR PASCAL AWSDBEGINBP (STRING szBPName, IDEN IBPAdmin, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The Business Process 
name. This name should be 
unique. If a business 
process- with the same 
name is present, the 
current definition is 
over written as a new 
version. There should be 
no active instances of 
the current definition 
for this to occur. 


IBPAdmin 


IDEN 


The Identity of the 
person creating this 
business process , The 
Identity should have the 
rights to create business 
processes . 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AKSDENDBP 

Description 

Close the currently open business process. A call 
to AWSDENDBP should be preceded by a call to AWSDBEGINBP . 

AWSDENDBP should be the last call when defining a 
business process. Every AWSDBEGINBP has to be closed by a 
AWSDENDBP. The AWSDENDBP should be the last call and ends 
the definition of a business process. The AWSDENDBP 
closes the context set up by AWSDBEGINBP . 
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Note: AWSDENDBP should be called only after a AWSDENDWF 
call has been made . 

Syntax 



VOID FAR PASCAL AWSDENDBP (LPERRCODE IpError) 

Parameters 



Name 


Tvpe 


Description 


IpError 


LPERRCODE 


Error code returned . 



Return VaXue 

Error code is returned. 



AWSDDEZ.ETEBP 

Description 

Deletes a Business Process. The delete is 
successful only if the Business Process has no active 
instances in the activity database. This function is used 
to remove business processes no longer in use. This 
function is called only if the business process is not in 
progress. 

Syntax 

VOID FAR PASCAL AWSDDELETEBP (STRING szBPName, IDEN iBPAdmin, 
LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


szBPName 


STRING 


The name of the business 
TTiTTir***^^ +• o delete There 
should be no active 
instances for this 
BPName . 


IBP Admin 


IDEN 


The Identity of the 
person deleting this 
business process. The 
Identity should have the 
rights to delete this 
business processes. 


IpError 


LPERRCODE 


Error code returned . 



Return Value 

Error code is returned. 

AWSDSETBPBOUKDDATA 
Description 

Define the list of bound data fields associated with the 
business process. The field name, type, size, attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETBPBOUNDDATA (INT iFields, 

LPBDFIELDSTRUCT IpBDFieldStructPt r , 
LPERRCODE IpError) 
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Name 


Type 


Description 


iFields 


INT 


The number of 
fields to attach 
with the business 
process . 


IpBDFieldStructPtr 


LPBDFIELDSTKUCi 


pO Xll UtSX. L. Oil 

array of 
structures 
containing field 
name, type, size, 
attributes and 
initial value, if 
any. 


IpError 


LPERRCODE 


Error code 
returned . 



Ret;urn Value 

Error code is returned. 

AWSDBEGINWF 

Descri.pt ion 

Creates a new workflow in a Business Process. The 
workflow name is specified as a parameter. The workflow 
name should be uniqpae . If a workflow with the 3ame name 
is present, then the context for this workflow is set up. 

The AWSDBEGINWF should be the first call when 
defining a workflow and no other AWSDBEGINWF call should 
be in progress. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. 

AWSDBEGINWF sets up a context for the workflow and 
all subsequent workflow calls require this context. The 
AWSDENDWF closes this context . 

Syntax 
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VOID FAR PASCAL AWSDBEGINWF (STRING szWFNaroe, LPERRCODE IpError) 



Name 


Type 


Description 


szWFName 


STRING 


The workflow name. This 
name should be unioue . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AHSDENDHF 

Description 

Close the currently open workflow. A call to 
AWSDENDWF should be preceded by a call to AWSDBEGINWF, 

The AWSDENDWF should be the last -call when defining 
a workflow. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. The AWSDENDWF should be the last call and 
ends the definition of a workflow. The AWSDENDWF closes 
the context set up by AWSDBEGINWF. 

Syntax 



VOID FAR PASCAL AWSDENDWF (LPERRCODE IpError) 





1 Katne 


Tvpe 


Description 


1 IpError 


LPERRCODE 


Error code returned. 1 



Return Value 

Error code is returned. 

AWSDSETWFINFO 
Description 
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Specify workflow information- The workflow type, • 
the organization role for the customer and performer, the 
time offsets for completion and reply are specified. This 
call must be made only after AWSDBEGINWF is called. 

Syntax 

VOID FAR PASCAL AWSDSETWFINFO (WFTYPE WFType, BOOL bCentralWF, 
IDEN ICustomer, IDEN IPerformer, 
liPERRCODE IpError) 



Parameters 



Name 


Tvpe 


Description 


WFType 


WFTYPE 


This specifies the type 
of workflow, i.e.. 
Request or Offer or 
Note . 


bCentralWF 


BOOL 


Flag to indicate if this 
workflow is the central 
workflow of the Business 
Process. This flag ±s 
TRUE if it is the 
central workflow, FALSE 
otherwise . 


ICustomer 


ORGROLEID 


The Organization Role of 
the Customer. 


IPerf ormer 


ORGROLEID 


The Organization Role of 
the Perforiner. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDSETWFCYCLETIME 

Description 

Set the various cycle times associated with the 
workflow. Depending on the workflow type — J^eqruest or 
Offer, the response time for each act of the workflow may 
be specified. The table below enumerates the various 
times that can be stored. 
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Read table below as : 

<OrgRolel> must <A.ct:ioxil> [after <OrgRole2> <Action2> ] within 
time <time> 



SI . 


OrcrRolel 


Actionl 


OraRoleZ 


Actlon2 


1 


Customer 


Recmest 






2 


Performer 


Respond 


Customer 


Reauest 


3 


Performer 


Complete 


Customer 


Reouest 


4 


Customer 


Respond 


Performer 


Declares 
completion 



SI 


OrgRolel 


Act: ionl 


OrgRole2 


Action2 


1 


Performer 


Offer 






2 


Customer 


ResDond 


Performer 


Offer 


3 


Performer 


Complete 


Customer 


Acrreement 


4 


Customer 


Respond 


Performer 


Declares 
completion 



Note: The call must be made only after function 
AWSDSETWFINFO is called. 

Syntiax 



VOID FAR PASCAL AWSDSETCYCLETIME (LPCYCLETIME IpCycleTime, 
LPERRCODE IpError) 
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Parameters 



Kame 


Type 


Description 


IpCycleTime 


LPCYCLETIME 


Pointer to an array of 
time offsets. Depending 
on the workflow type the 
array elements refer to 
different times are 
listed in the tables 
above . Since the number 
of cycle times for each 
workflow type is known, 
the count is not 
reouired. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDDXSABIiEWFACT 

Description 

Disable a set of workflow acts for a specific 
workflow role. By default all acts are enabled for a 
workflow. This call facilitates disabling specific acts. 
This call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDDISABLEWFACT (WFROLE WFRole, INT iCountr 
LPACTINFO ActPtr, LPERRCODE IpError) 



SUBSTITUTE SHEET (RULE 26) 



wo 94/18620 



151 



PCT/US94/01287 



Parameters 



Kame 


Tvpe 


Description 




WFRole 


WFROLE 


The Workflow Role for 
which the acts are to be 
disabled. 




iCount 


INT 


The number of acts to 
disable , 




ActPtr 


LP ACT INFO 


A pointer to an array of 
structures which 
contains the list of 
acts to disable. The 
number of acts is 
specified by parameter 
nCount 




IpError 


LPERRCODE 


Error code returned. I 



Return Value 

Error code is returned. 



AWSDSETACTUSERDSFXNEDNAME 

Description 

Set the user-defined description for the workflow 
Acts. The list of acts and the equivalent user-defined 
names are provided. This call must be made only after a 
call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL. AWSDSETACTUSERJOEFINEDNAME (INT iCount, 
LPACTINFO ActPtr, LPERRCODE IpError) 
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Parameiiers 







Descrxp^xon 




INT 


The number of acts for 
which the user-defined 
name has been provided. 


ActPtr 


LP ACT INFO 


A pointer to an array of 
structures which 
contains the list of 
acts, i.e.. Act Names 
and user-defined Names 
for the acts. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDSETSTATEUSERDEFINEDNAME 

Description 

Set the User-defined description for the workflow 
states. The list of states and the equivalent user- 
defined names are provided. This call must be made only 
after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETSTATEUSERDEFINEDNAME (INT iCount, 

LPSTATEINFO StatePtr, LPERRCODE IpError) 



Parameters 



Name 


Type 


Des crlpt Ion 


iCount 


INT 


The number of states for 
which the user-defined 
name has been provided. 


StatePtr 


LPSTATEINFO 


A pointer to an array of 
structures which 
contains the list of 
states, i.e.. State 
Names and user-defined 
names for the states. 


loError 


LPERRCODE 


Error code returned. 
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Retiurn Value 

Error code is returned. 

AWSDSETACTSCRXPT 
Description 

Set the workflow script for an Act . The act and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETACTSCRIPT (ACT Act, LPMEM IpActScript, BOOL 
bScriptType, LPINT IpiMemBlocJtSize, 
INT iPositionNotify, ERRORCODE iError) 

Parameters 
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Name 


Tvpe 


Description 


Act 


ACT 


The type of act, e.g.. 
Request^ Aaresr etc. 


IpActScript 


LPMEM 


The workflow script 
associated with the 
act. The script is 
executed when the 
corresponding act in 
the workflow is 
executed. 


bScriptType 


BOOL 


Script Type is a 
Boolean flag which 
indicates whether the 
script is System 
generated or user 
generated. 


IpiMemBlockSize 


LP INT 


Size of the memory 
block in bytes. 


iPositionNotif y 


INT 


This variable 
identifies the first 
script buffer, 
subsequent buffers and 
the last one - It 
should be set to 0 to 
identify first map 
buffer, 1 to identify 
subsequent map buffers 
and to 2 to indicate 
last buffer. 


IpError 


LPERRCODE 


Error code returned . 



Keturn Value 

Error code is returned . 



Act script added to the workflow. 

AWSDSETSTATESCRIPT 

Descripiilon 

Set the workflow script for a State. The state and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF. 

Syntax 
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VOID FAR PASCAL AWSDSETACTSCRIPT (STATE State, LPMEM IpStateScript , 
BOOL bScriptType, LPINT IpiMemBlockSize, 
INT iPositionNotify, LPERRORCODE IpError) 



Name 


Tvpa 


Description 


State 


STATE 


The type of state, e.g.. 
Initiate, Negotiation, 
Completing, Satisfied, 
etc . 


IpStateScript 


LPMEM 


The workflow script 
associated with the 
state. The script is 
executed when the 
workflow transits to the 
soecified state. 


bScriptType 




Qr« -r- -i -n't- T\/Ti<=k 5 ^ a "Boolean 
flag which indicates 
whether the script is 
System generated or user 
aenerated . 


IpiMemBlockSize 


LPINT 


Size of the memory block 
in bvtes. 


iPositionNotif y 


INT 


This variable identifies 
the first script buffer, 
subsequent buffers and 
the last one. It should 
be set to 0 to identify 
first map buffer, 1 to 
identify subsequent map 
buffers and to 2 to 
indicate last buffer. 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned- 

State script added to the workflow. 

AWSDSETHFBOaKDDATAFXELDS 

Description 
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Define the list of bound data fields associated with the 
workflow. The field name, type, size, default attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETWFBOUNDDATAFIELDS (INT iFields, 
LPBDFIELDSTRUCT IpBDFieldStructPtr , 
LPERRCODE IpError) 



Name 


Type 


Descr xpt ion 


iFields 


INT 


The number of 
fields to attach 
with the 
workflow. 


IpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an 
array of 
structures 
containing field 
name, type, size, 
default 

attributes and 
initial value, if 
anv . 


IpError 


LPERRCODE 


Error code 
returned . 



Return Value 

The bound data fields are attached to the workflow. 
Error code is returned . 
AWSDSETWFBDFIELDATTRIBUTE 

Description 

Define the field attributes of bound data fields 
associated with the workflow. The field attributes. Read- 
only, Editable, Hidden and MustFill, may be specified for 
each Act and/or State for a specific workflow role. 
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A call to AWSDSETWFBDFIELDATTRIBUTE must be made 
only after calling AWSDSetWFBoundDataFields . 

Syntax 

VOID FAR PASCAL AWSDSETWFBDFIELDATTRIBUTE (INT iFieldS, 

LPWFMOMENTBDFIELDSTRUCT IpWFMomentBDFieldSt ruct , 
LPERRCODE IpError) 



Parameters 



Name 




Description 


iFields 


INT 


The number of 
fields to 
attach with 
the workflow. 


IpWFMoment BDFiel dS t rue t 


LPWFMOMENTBDFIELDSTRUCT 


A pointer to 
an array of 
structures 
containing 
field name, 
Act or State, 
Workflow Role 
and 

attributes . 
The 

attributes 
are: Read- 
only, 
Editable, 
Hidden and 
MustFill. 


IpError 


LPERRCODE 


Error code 
returned. 



Return Value 

Error code is returned. 



The attributes of the bound data fields are attached to 
the workflow, 

AWSDSETFORMINFO 

Description 
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Specify workflow form names for Customer, Performer 
and Observer. 

Syntax 

VOID FAR PASCAL AWSDSETFORMINFO (STRING szCusForm, 
STRING szPerForm, STRING szObsForm, 
STRING szInitForm, LPERRCODE IpError) 



Parameters 



Mama 


Tvpe 


Description 


szCusForm 


. STRING 


Form name for Customer 
of workflow 


szPerForm 


STRING 


Form name for Performer 
of workflow 


szObsForm 


STRING 


Form name for Observer 
of workflow 


szInitForm 


STRING 


Init form name of the 
workflow 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

Form names attached to the workflow 
AWSDSETFOLLOWUP 

Description 

Set up follow-up information associated with the 
workflow. The follow-up time offsets for Completion, 
Reply and Reminder are specified. 

A follow-up is sent after the Completion is past 
due. It is sent at the specified time interval after it 
is past due. If the recurring flag for Completion is set, 
then till Completion, follow-up messages are sent at 
every time interval specified. The maximum number of 
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times a follow-up notification is sent could be set using 
this call. 

A follow-up is sent after the Reply is past due. It 
is sent at the specified time interval after it is past 
due. If the recurring flag for Reply is set, then till 
-Reply has been sent, follow-up messages are sent at every 
time interval specified. The maximum number of times a 
follow-up notification is sent could be set using this 
call . 

A, reminder may be sent before Completion or Reply 
is due. The reminder is sent at a time interval specified 
before the event is due. Reminders may be disabled. A 
reminder is sent only once. 

Synbax 

VOID FAR PASCAL AWSDSETFOLLOWUP (BOOL bPCFUFlag, 

TIMEOFFSET PCFUOffset, BOOL bPCFURecur, 
INT iPCFUCount, BOOL bPRFUFlag, 
TIMEOFFSET PRFUOffset, BOOL bPRFURecur, 
INT iPRFUCount, 

BOOL bCRFUFlag, TIMEOFFSET CRFUOffset, 
BOOL bCRFURecur, INT iCRFUCount, 
TIMEOFFSET PCRemOffset, BOOL bPCRemFlag, 
BOOL bActNotifyFlag, LPERRCODE IpError) 



Paramefcers 



Name 


Type 


Descriptiion 


bPCFUFlag 


BOOL 


Performer completion 
follow-up flaa. 


PCFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by PCFUOffset, 
after performer 
completion is oast due. 
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bPCFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every PCFUOffset 
interval as many as 
PCFUCount times. 


iPCFUCount 


INT 


Number of times the ^ 
follow-up notifications 
should be sent after 
performer completion is 
past due . 

If this parameter is not 
specified, and PCFUFlag 
is set, then 
notifications are sent 
till performer 
completes . 


bPRFUFlag 


BOOL 


Performer response 
follow-ur> flaa 


PRFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after 
Performer reply is past 
due . 


bPRFURecur 




If enabled, recurring 
notifications are sent 
at every PRFUOffset 
interval as many as 
PRFUCount times. If 
PRFUFlag is set TRUE and 
PRFUCount is not 
specified, then follow- 
up messages are sent 
until performer replies. 


iPRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
performer Completion is 
past due. 

If this parameter is not 
specified, and PRFUFlag 
is set, then 
notifications are sent 
till performer 
completes . 


bCRFUFlag 


BOOL 


Customer response 
follow-up flaa 
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CRFUOff set 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after customer 
reply is past due. 


bCRFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every CRFUOff set 
interval as many as 
CRFUCount times. 


iCRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
Customer Completion is 
past due . 

If this parameter is not 
specified/ . and CRFUFlag 
is set, then 
notifications are sent 
till customer replies. 


■PCRemOf f set 


TIMEOFFSET 


A reminder is sent at an 
interval PCRemOffset 
before Completion or 
Reolv is due . 


bPCRemFlag 


BOOL 


If this flag is enabled, 
reminders are sent. If 
disabled, no reminders 
are sent . 


bActNotifyFlag 


BOOL 


Indicates notification 
status. If set to TRUE, 
notification is- enabled 
else if set to FALSE, it 
is disabled. 


loError 


LPERRCODE 


Error code returned. 



Reburn Value 

Error code is returned. 

Follow-up information attached to the .workflow 
AWSDSETLINK 

Description 

Specify a in coming link to a workflow. For each 
link, the source workflow name, triggering and triggered 
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information is provided. Triggering information 
constitutes whether the link is anchored at an act or 
state and the act/state name. Triggered information 
constitutes whether the link terminates at an act or 
state and the act/state name. 

Note: AWSDSETLINK must be called only after all workflows 
have been created using AWSDBEGINBP. 

Syn'tax 

VOID FAR PASCAL AWSDSETLINK (STRING szFWFName, 

BOOL bFActOrState, ACTSTATEID FActState, 
STRING szTWFName, BOOL bTActOrState, 
ACTSTATEID TActState, LPERRCODE IpError) 



Paramerers 
Mame 


Tvpe 


Description 


szFWFName 


STRING 


The source or "from" 
workflow name. The name 
of the workflow where a 
link is anchored. 


bFActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
source . — 


FActState 


ACTSTATEID 


The act or state from 
where the link starts. 


szTWFName 


STRING 


The destination or "to" 
workflow name. The name 
of the workflow to which 
the link is taraeted. 


bTActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
destination . 
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TActState 


ACTSTATE 


The act or state where 
the link ends. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Link information attached to the workflow 

Error code is returned. 

AWSDPUTMAP 

Description 

Associates a map file with the specified Business 
Process. The map file is inserted as a series of memory 
blocks. This function requires the business process 
context to be setup before execution. 

Syntax 

VOID FAR PASCAL AWSDPUTMAP (LPMEM IpMapMemPtr, LP INT 
IpiMemBlockSize, INT iPosit ionNot if y, 
LPERRCODE IpError) 



Parameters 



Name 


Tjyjpe 


Des cript ion 


IpMapMemPtr 


LPMEM 


Pointer to a memory block 
containincr map. 


IpiMemBlockSize 


LP INT 


Size of the memory block in 
bvtes . 


iPositionNotif y 


INT 


This variable identifies 
the first map buffer, 
subsequent map buffers and 
the last one. It should be 
set to 0 to identify first 
map buffer, 1 to identify 
subseauent map buffers. 


loError 


LPERRCODE 


Error code returned. 
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Return Value 

Error code is returned. 



AWSDGETHAP 



Descripblon 

Get the map file associated with the specified 
Business Process. The map file is returned as a series 
of memory blocks . The memory block pointer and the block 
size allocated is passed to this function and the number 
of bytes actually written in the memory block is 
returned. Initially, the caller must pass a zero in the 
Offset variable to indicate start of the block transfers . 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 



Syntax 

VOID FAR PASCAL AWSDGETMAP (STRING szBPName, LPMEM 
IpMapMemPtr, LPINT IpiMeinBlockSize, 
LPLONG IpOffset, LPERRCODE IpError) 

Parameters 
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Name 


Type 


Description 


szBPName 


STRING 


Business Process Name with 
which to associate the 
mao . 


IpMapMemPtr 


LPMEM 


Pointer to a memory block 
where mao can be returned. 


IpiMemBlockSize 


LP INT 


Size of the memory block 
in bvtes. 


IpOf f set 


LP LONG 


Initially, the caller must 
set this to zero. Each 
block transfer changes the 
value contained in this 
variable and the caller 
can only check the value 
returned here. This will 
be negative if end is 
reached. 


IpError 


LPERRCODE 


Error code returned. 



Ret:urn Value 

Number of bytes actually written. 
Error code is returned. 
AWSDBPADDROLEASSXGKKEKT 

Description 

Sets the Organization Role to Identity mapping at 
the Business Process level. 

Syntax 

void FAR PASCAL AWS DBF ADD ROLE ASSIGNMENT ( IDEN lldentity, 
IDEN lOrgRoleld, LPERRCODE IpError) 

Parameters 
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Name 


Tvpe 


Description 


lldentitv 


TDEN 


Oraanizaticn Role id. 


lOrgRoleld 


IDEN 


Identity Id to be mapped 
with OraRole 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
AWSDWFADDROZ.EASSXGNMEHT 

Description 

Sets the Organization Role to Identity mapping at 
the workflow level. 

Syntax 

void FAR PASCAL AWSDWFADDROLEASSIGNMENT (IDEN lldentity, 
IDEN lOrgRoleld, WFROLE WFRole, 
LPERRCODE IpError) 



Parameters 



Name 


Tvpe 


Description 


lldentity 


IDEN 


Identity Id to be mapped 
with OraRole . 


lOraRoleld 


IDEN 


Oraanization Role id. 


WFRole 


WFROLE 


Workflow role of the 
identity. 


loError 


LPERRCODE 


Error code returned . 



Return Value 
AWSDGETBPVERSION 

Description 

Get the current BP Version for the specified BP 
name. The function returns the Business Process Version. 

Syntax 
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VOID FAR PASCAL AWSDGETBP VERS ION (IDEN lldentity, STRING 
szBPName, 

LP INT IpiVersion, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lldentity 


IDEN 


Identity Id to be mapped with 
OraRole . 


sz BP Name 


STRING 


The name of the BP for which 
the version number is 
reqxiested 


IpiVersion 


LP INT 


Pointer to an integer which 
holds the version number of BP 


IpError 


LPERRCODE 


Error code returned. 



Return Value 



AWSDGETLASTMODXFIEDDATE 
Description 

This function returns the last modified date of the 
Business Process specified. 

Syntax 

VOID FAR PASCAL AWSDGETLASTMODIFIEDDATE (STRING szBPName, 
LPDATETIME pdtLastModif ied^ 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The name of the BP for 
which the last modified 
date is reouested 


IpdtLastModif ied 


LPDATETIME 


The pointer to the 
DATETIME type which 
holds the last modified 
date of the Business 
Process . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
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AWSDSETBPNOTIFXCATXON 



Description 

The notification string for the event is set with 
respect to the current BP context . 

Syntax 



void FAR PASCAL 

AWSDSETBPNOTIFICATION (EVENT Notif icat ionE 
vent, STRING szNotif icationSt ring. 



LPERRCODE IpError) 
Parameters ^ 



Name 


Tvpe 


Description 


Notif icat ionEvent 


EVENT 


This parameter 
notifies the event 


szNotif icat ionSt ring 


STRING 


The notification 
strina . 


IpError 


LPERRCODE 


Error code returned . 



Notification Events 



Event 


Notification 
Tvpe 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion comina due 


Reminder 


Customer Response past due 


Follow-up 


Act taken 


Act 


Return Value 



AWSDSETWFNOTIFICATION 

Description 

The notification string for the event is set with 
respect to the current WF context . 

Syntax 
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void FAR PASCAL 

AWSDSETWFNOTIFICATION (EVENT Not if icationE 
vent, STRING szNotif icationString, 



LPERRCODE IpError) 

Parameters 


Name 


Tvpe 


Description 


No t i f i cat i onE ven t 


EVENT 


This parameter 
notifies the event 


szNotif icationString 


STRING 


The notification 
strincr . 


IpError 


LPERRCODE 


Error code returned. 


Notification Events 


Event 


Notification Tvpe 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion cominq due 


Reminder 


Customer Response past due 


Follow-up 


Act taken 


Act 


Return Value 
AWSDSETCOS 



Description 

This function specifies COS associated with a 
workflow of a Business Process. The COS is inserted as a 
series of memory blocks . This function requires the 
Business Process context and workflow to be setup before 
execution . 

Syntax 

VOID FAR PASCAL AWSDSETCOS (LPMEM IpCOS, 
LP INT IpiMemBlockSize , 

INT iPositionNotify, LPERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


IpCOS 


LPMEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


IpiMemBlockSize 


LP INT 


Memory allocated for 
storinq COS in bvtes . 


iPositionNotif y 


INT 


This variable 
identifies the first 
COS buffer, subsequent 
COS buffers and the 
last one. It should be 
set to 0 to identify 
first buffer, 1 to 
identify subsequent 
buffers and to 2 to 
indicate last buffer. 


iDError 


LPERRORCODE 


Error code returned . 



Retiurn Value 



AKSDGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks . The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 

VOID FAR PASCAL AWSDGETCOS (STRING szBPName, 
STRING szWFName, LPMEM IpCOS, 
LP INT IpiMemBlockSize, LPLONG IpOffset, 
LPERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


szBPName 


STRING 


Business Process Name 


szWFName 


STRING 


Workflow Name 






Pointer to a memory chunk which 
stores COS (BLOB) . 


IpiMemBlock 
Size 


LP INT 


Memory allocated for storing 
COS in bvtes . 


IpOf fset 


LPLONG 


Initially, the caller must set 
this to zero . Each block 
transfer changes the value 
contained in this varieible and 
the caller can only check the 
value returned here. This will 
be neaative if end is reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 



AWSDWFADDOBSROLE 

Description 

Sets the Observer Organization Role(s) at the 
workflow level. 

Syntax 

VOID FAR PASCAL AWSDWF AD DOBS ROLE ( IDEN lOrgRoleld, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Des crip tic n 


lOrqRoleld 


IDEN 


Oraanization Role id. 


loError 


LPERRCODE 


Error code returned. 



Return Value 



AWSDWFDELETEOBSROLE 
Description 
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Deletes the Observer Organization Role(s) at the 
workflow level . 

Syntax 

VOID FAR PASCAL AWSDWFDELETEOBSROLE (IDEN lOrgRoleld, 



LPERRCODE IpError) 
Parameters 



Kame 


Type 


Descrxption ^ 


lOrcrRoleld 


IDEN 


Oraanization Role id. 


IpError 


LPERRCODE 


Error code returned . 



Return Value 

Kames and Routings APX 
AWSNADDORGROLE 



Description 

Add a new Organization Role name to the server. 
This name should be unique. The Organization Role Id is 
returned. 

Syntax 

VOID FAR PASCAL AWSNADDORGROLE (STRING szOrgRoleName, 
LP IDEN IpOrgRoleld, 
IDEN lAuthorize Identity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szOrgRoleName 


STRING 


The Organization Role 
name to add to the 
server. The name should 
be uniaue. 


IpOrgRoleld 


LPIDEN 


The OrgRoleld is 
returned on successful 
addition of Organization 
role name to the server. 


lAuthorize Identity 


IDEN 


Identity of the person 
adding the name to the 
server. The Identity 
must be authorized to 
add names. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Organization Role Id, OrgRoleld is returned by the 
function . 



AWSNINQUXREORGROLE 
Description 

Inquire if a specified Organization Role is present 
in the server database. If present, the Organization Role 
Id is returned . 

Syntax 

VOID FAR PASCAL AWSN INQUIRE ORG ROLE (STRING szOrgRoleName, 
LPIDEN IpOrgRoleld, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Name 


Type 


Description 


IGroupId 


IDEN 


The Groupid of the 
group from which to 
reinove GjroupMertihe r . 


IG r oupMemb e r I d 


IDEN 


The Identity of the 
person being removed 
from the Group, 
identified bv Grouvld. 


lAuthorize Identity 


IDEN 


The Identity of the 
person deleting. The 
person must have the 
authority to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Identity is removed from the group. 



AWSKGETGROUPLIST 

Description 

Determine the list of groups an Identity is a 
member of. This function returns a list and a count. 

Syntax 

VOID FAR PASCAL AWSNGETGROUPLIST ( IDEN IGroupMemberld, 
LPINT IpiCount, BOOL bFileOrMemory , 
LPGENERALINFO IpGroupInf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


T vpe 


Descrxp^lon 


IGroupMemberld 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
by Group Jd. 


IpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of. This 
value is returned. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


IpGroupInf oArray 


LPGENERALINFO 


The list of groups 
GroupMember is a 
member of. For each 
group, the Group Id 
and Group Name are 
returned. A pointer 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAut hor ize Ident i ty 


IDEN 


The Identity of the 
person Inquiring. 
The person must 
have the authority 
to Inauire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups and a list of Groupid and 
GroupName returned . 



AWSNGETGROUP MEMBERS 
Description 
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Get the list of all members in a group. The 
Identity of each member in a group is returned. The 
IdentityName is also returned. 

Synl^ax 

void FAR PASCAL AWSNGETGROUPMEMBERS ( IDEN IGroupId, 
LPINT IpiCount, BOOL bFileOrMemory, 
LPGENERALINFO IpMemberInf oArray, 
• STRING szFileNamer 
IDEN lAuthorizeldentity, 
■ LPERRCODE IpError) 
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Kama 


Tvpe 


Description 


IGroupId 


IDEN 


The Group Id of 
the group from 
which to retrieve 
list of members. 


IpiCount 


LP INT 


Pointer to 
nCount, the 
number of members 
in the Group. 


bF i 1 eOrMemor y 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt 
of data from the 
API . 


IpGenerallnfoArray 


LPGENERALINFO 


A list of members 
in the group is 
returned. The 
list contains the 
Identityld and 
IdentityName of 
each member. 
IpGen eralln foArra 
y is a pointer to 
an arrav. 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of 
the person 
inquiring. The 
person must have 
the authority to 
incruire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

List of members returned. 



AWSNADD RO LEAS S I GNMENT 

Description 

Assign an Identity or a Group to an Organization 
Role. The Identity or all members of the group are 
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assigned the specific Organization Role. Follow-up 
flags to enable/disable Reminders and Follow-up 
messages may be specified here. If an assignment is 
already present then the new Follow-up flags are 
assigned. 

Syntax 

VOID FAR PASCAL 

. AWSNADDROLEASSIGNMENTCBOOL bCroupOrlderi 

tity, IDEN lAssigneeld, 
IDEN lOrgRoleld, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bG r oupOr I den t it y 


BOOL 


Flag to indicate if 
Assignee is an identity 
or a Group. If 
GroupOrldentlty is 
TRUE, then Assignee 
contains a Groupid, 
otherwise it is an 
Identity. 


lAssignee 


IDEN/ IDEN 


The id of the Identity 
or Group being assigned 
the Organization Role. 
If a Group is being 
assigned, then all 
members of the group 
inherit the Role 


lOrgRoleld 


ORGROLEID 


The Organization Role 
the Identity or Group 
will be assicrned. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person assigning role. 
The person must have 
the authority to make 
this assianment. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

Identity/Group assigned Organization Role. 
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AWSNINQUIREROLEASSIGNMENT 

Description 

Verify if a specific Identity is associated with 
an Organization Role. The function returns a flag. The 
Identity is first checked if it is associated with the 
Organization Role. If no association is found, then a 
check is made if an association exists with any of the 
groups Identity is a member of. 

Syntax 

BOOL FAR PASCAL 

AWSNINQUIREROLEASSIGNMENTEXTENDED (BOOL 

bGroupOrldentity, IDEN lAssignee, 

IDEN lOrgRoleld, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bG r oupOr I dent i t y 


BOOL 


Flag to indicate if 
Assignee is an identity 
or a Group. If 
GroupOrldentlty is 
TRUE, then Assignee 
contains a Groupid, 
otherwise it is an 
Identity. 


lAssignee 


IDEN 


The id of the Identity 
beina inauired. 


lOrgRoleld 


IDEN 


The Organization Role 
being verified for the 
Assignee . 


lAuthorizeldentity 


IDEN 


The Identity of the 
person inquiring the 
association. The person 
must have the authority 
to incruire. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Retiurn Value 
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The function returns a TRUE if the association is 
present, FALSE otherwise. If the association exists 
then the Follow-up flags are also returned. 

AWSNDELETEROLEASSIGNMENT 

Description 

Disassociate an Identity or Group from a specific 
Organization Role. The Identity or all members of the 
group cease to. be associated with the Organization 
Role . 

Syntax 

VOID FAR PASCAL 

AWSNDELETEROLEASSIGNMENT (BOOL bGroupOrl 
dentity, IDEN lAssignee, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bGroupOr Identity 


BOOL 


Flag to indicate if 
Assignee is an Identity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupid, 
otherwise it is an 
Identity. 


lAssignee 


IDEN 


The id of the Identity 
or Group being 
disassociated . 


lAuthorize Identity 


IDEN 


The Identity of the 
person deleting the 
association. The person 
must have the authority 
to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 
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AWSNGETROLELXST 

Description 

Determine the list of Roles that are assigned to 
a specific Identity or Group. This function returns a 
list of Organization Roles and a count. 

Syntax 

VOID FAR PASCAL AWSNGETROLEL 1ST (BOOL bGroupOr Identity , 
IDEN lAssignee^ LPINT IpiCount, 
BOOL bFileOrMemory, 
LPGENERALINFO IpOrgRoleInf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Name 


Type 


t£ s> w ^ ^ >^ \^ ^ \^ *■* 


bGroupOr Identity 


BOOL 


Flag to indicate 
if Assignee is a 
iQenuicy oi a. 
Group. If 
GroupOr Identity is 
TRUE, then 
Assigrnee contains 
a Groupid, 
otherwise it is 


lAssignee 


IDEN 


The id of the 
Identity or Group 
beina inauired. 


IpiCount 


LP INT 


Pointer to a 
counter. The 
number of 

Organization Roles 
an Identity/Group 
is assianed. 


■ bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt of 
data from the API. 


IpOrgRoleInf oArray 


LPGENERALINFO 


The list of 
Organization Roles 
Assignee is 
assigned to. For 
each Role, the 
OrgRole, Follow-up 
flags and. the 
description are 
returned. A 
pointer to a list 
of OrgRoles and 
description is 
returned . 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of 
the person 
Inquiring. The 
person must have 
the authority to 
Inouire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 
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Return Value 

List and Count returned. 

AWSKGETXDENASSIGNEELIST 

Description 

Determine the list of Identities that are 
assigned to a specific Organization Role- This 
function returns a list of Identities and their names. 

Syntax 

VOID FAR PASCAL 

AWSNGETIDENASSIGNEELIST (IDEN lOrgRoleld 

, LP INT IpiCountr BOOL bFileOrMemory , 

LPASSIGNEE Ipldeninf oArray, 

STRING szFileName, 

IDEN lAuthorizeldentity, 

LPERRCODE IpEr ror ) 
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Parame'bers 



Name 


Type 


Des cript ion 


lOrgRoleld 


IDEN 


The Organization Role 
for which list of 
Assignees is being 
returned. 


IpiCountPtr 


LP INT 


Pointer to a counter. 
The number of 
Assignees ( Identities 
or Groups) associated 
with the Organization 
Role OraRole 


bFileOrMemory 


BOOL 


Flag to indicate File 
or Memory mode of 
receipt of data from 
the API. 


Ipldeninf oArray 


LP ASSIGNEE 


List of identities who 
are associated ■ with a 
specific organization 
role. The bNotify flag 
associated with the 
Identity is also 
returned. A pointer to 
a list is returned. 


szFileName 


STRING 


File name where the 
API should deposit the 
results of the call if 
the flag bFileOrMemory 
is ITS FILE. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inouire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

List and Count returned. 



AWSNGETGROUPASSIGNEELIST 

Description 

Determine the list of Identities and Groups that 
are assigned to a specific Organization Role. This 
function returns a list of Identities and Group and 
their names . 

Syntax 
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VOID FAR PASCAL 

AWSNGETGROUPASSIGNEELIST ( IDEN lOrgRolel 

LP INT IpiCount, BOOL bFileOrMemory, 
LPGENERALINFO IpGroupInf oArray, 
STRING szFileName, 
IDEN lAuthorize Identity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lOrgRoleld 


ORGROLEID 


The Organization 
Role for which list 
of Assignees is 
beina returned. 


IpiCountPtr 


LP INT 


Pointer to a 
counter. The number 
of Assignees 
(Identities or 
Groups) associated 
with the 

Organization Role 
OrcrRole 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


IpGroupInf oArray 


LPGENERALINFO 


List of groups who 
are associated with 
a specific 
organization role . 
A pointer to a list 
is returned. 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person recjuesting 
the list . The 
person must have 
the authority to 
inouire . 


IpError 


LPERRCODE 


This is set to a 
non— zero value on 
error 



Return Value 
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List and Count returned. 
AWSNCREATESTFDEFN 

Descript:ion 

Create an entry in the STF Processor table. The 
processor name and the network address is maintained. 
The STF Processor Id is returned. 

Syntax 

VOID FAR PASCAL 

AWSNCREATESTFDEFN (STRING szSTFProcName/ 
STRING szNetAddress, 
LPIDEN IpSTFProcId, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Kame 


Type 


Description 


szSTFProcName 


STRING 


The name of the STF 
Processor . 


szNet Address 


STRING 


The network address of 
the location of the STF 
Processor. The 
processor must exist 
for this call to return 
successfully . 


IpSTFProcId 


LPIDEN 


The STFProc Id is 
returned . 


lAuthorize Identity 


IDEN 


The Identity of the 
person Creating the STF 
definition. The 
identity must be 
authorized to create 
STF definition. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessorld returned. 
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AWSNGETSTFDEFN 

Description 

Get the STF definition from the STF Processor 
table for a specific STF Processor Id. The processor 
name and the network address are returned. 

Syntax 

VOID FAR PASCAL AWSNGETSTFDEFN (IDEN ISTFProcId, 
STRING szSTFProcName, 
STRING szNetAddress, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Des crlptlon 


ISTFProcId 


IDEN 


The STF Processor Id. 


szSTFProcName 


STRING 


The name of the STF 
Processor is returned. 


s zNe t Addr e s s 


STRING 


The network address of 
the location of the STF 
Processor is returned. 


lAuthorize Identity 


IDEN 


The Identity of the 
person inquiring the 
STF definition. The 
identity must be 
authorized to inauire. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessor name and net address returned. 
AWSNDELETESTFDEFN 

Description 

Delete the STF definition from the STF Processor 
table for a specific STF Processor Id. 

Syntax 
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PASCAL AWSNDELETESTFDEFNdDEN STFP 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 
Name 

STFProcId 

lAuthorizeldentity 


Tvt>e 1 

THEN 
IDEN 


Descri'Ption 

The STF Processor Id. 
The Identity of the 
person deleting the 
STF definition. The 
identity must be 
authorized to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessor name and net address returned. 
AWSNGETNUMGROUPIilST 

Description 

Determine the number of groups an Identity is a 
member of. This function returns a count. 

Syntax 

VOID FAR PASCAL 

AWSNGETNUMGROUPLIST (IDEN IGroupMember 
LP INT IpiCount, BOOL bFileOrMemory, 
LPGENERALINFO IpGroupInf oArray , 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Kama 


Tvpe 


Description 


IGroupMemberld 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
by Group Jd. 


IpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of. This 
value is returned. 


bFileOrMemory . 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


IpGroupInf oArray 


LP GENERAL INFO 


The list of groups 
GroupMember is a 
member of . For each 
group, the Group Id 
and Group Name are 
returned. A pointier 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person Inquiring, 
The person musn 
have the authority 
to Inauire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups is returned. 



AWSNGETNUMGROUPMEMBERS 

Description 

Get the number of all members in a group. 

Syntax 
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PASCAL AWSNGETNUMGROUPMEMBERSdDEN IGroupId, 
LP INT IpiCcunt, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 
Name 

IGroupId 


Type 

IDEN 


DeseritJtion 

The GroupId of the 
group from which to 
retrieve list of 
members . 


IpiCount 


LP INT 


Pointer to nCount, 
the number of 
members in the 
Grout) . 


lAuthorizeldentity 


IDEN 


The Identity of the 
person inquiring . 
The person must 
have the authority 
to inquire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

Number of members returned. 



AWSNGETNUMROIiEI^IST 

Description 

Determine the number of Roles that are assigned 

to a specific Identity or Group. 



Syntax 



VOID FAR PASCAL 

AWSNGETNUMROLELIST (BOOL bGroupOr Ident 
y, IDEN lAssignee, LPINT IpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Kame 


Type 


Descrip't ion 


bGroupOr Identity 


BOOL 


Flag to indicate if 
Assignee is a Identity 
or a Group. If 
GroupOrldentlty is 
TRUE, then Assignee 
contains a Groupid, 
otherwise it is 


lAssignee 


IDEN 


The id of the Identity 
or Group being 
inouired . 


IpiCount 


LP INT 


irOmu€r a. oclixll.^?^ . 

The number of 
Organization Roles an 
Identity /Group is 
assianed. 


lAuthorize Identity 


IDEN 


The Identity of the 
person Inquiring. The 
person must have the 
authority to Inauire. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Ret.urn Value 



AHSNGKTNUMIDENASSXGKEELIST 

Descriptixon 

Determine the number of Identities that are 
assigned to a specific Organization Role. 

Syn'bax 

VOID FAR PASCAL 

AWSNGETIDENASSIGNEELIST (IDEN lOrgRoleld 

, LP INT Ipi.Count, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 
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Parametzers 
Name 

lOrgRoleld 


Tvpe 

IDEN 


Descri-Dtion 

The Organization Role 
for which list of 
Assignees is being 
returned. 


ip 1 ouiiu IT u r 


LP INT 


Pointer to a counter. 
The number of Assignees 
(Identities or Groups) 
associated with the 
Organization Role 
OrcrRoI e 


lAuthorizeldentity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



AWSNGETNUMGROUPASSIGNEELIST 



Descri.p'bi.on 

Determine the list of 
are assigned to a specific 
function returns a list of 
their names . 



Identities and Groups that 
Organization Role. This 
Identities and Group and 



Syntax 



VOID FAR PASCAL 

AWSNGETNUMGROUPASSIGNEELIST (IDEN lOrgRo 
leld, LPINT IpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


lOrgRoleld 


ORGROLEID 


The Organization Role 
for which list of 
Assignees is being 
returned . 


IpiCountPtr 


LP INT 


Pointer to a counter. 
The number of 
Assignees (Identities 
or Groups) associated 
with the Organization 
Role OrcrRole 


lAuthorize Identity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Keturn Value 



Schedule API 

The following is a description of the functions 
performed by the components of the Schedule API for 
implementation of the Schedule API. 
AWSSPUTBPSCHEDUI.E 

Description 

The schedule information associated with a 
business process is stored in the server. The time 
when the business process needs to be initiated and 
recurrence information are stored. 

Syntax 

VOID FAR PASCAL AWSSPUTBPSCHEDULE ( STRING szBPName, 
DATETIMET llnitTime, 
DATETIMET IRecurPeriod, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parame-bers 
Name 

szBPName 


Tvpe 1 

STRING . 


Description 

Business Process name. 
The business process 
for which schedule 
information needs to 
be attached. 


llnitTime 


DATETlWti J- 


The first time when 
the business process 
is initiated. If this 
is not specified, then 
the business process 
is not initiated by 
the Scheduler. 


IRecurPeriod 


DATETIMET 


If specified, the 
business process is 
initiated at every 
RecPeriod interval. 


lAuthorizeldentity 


IDENTITY 


Identity of the person 
placing scheduler 
request . ._ . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Keturn Value 

Schedule information stored in the server. 
AWSSGETBPSCHEDOLE 

Description 

The schedule information associated with a 
business process is returned. The initiation time 
recurrence information are returned. 

Syntax 

VOID FAR PASCAL AWSSGETBPSCHEDULE ( STRING szBPName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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T voe 


Description 


szBPName 


STRING 


Business Process Name. 
The business process 
for which schedule 
information is 
returned . 


lAuthorizeldentity 


IDEN 


Identity of the person 
requesting scheduler 
information . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Keturn Value 

Schedule information, initiation time and recurring 
period returned. 

AWSSDELETEBP SCHEDULE 

Description 

The schedule information associated with a 
business process is removed. However, currently active 
instances of the business process remain unaffected. 

Syntax 

VOID FAR PASCAL AWSSDELETEBP SCHEDULE (STRING szBPName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 

Name i 


Tvpe 1 


Descr i-Dtion 




szBPName 


STRING 


Business Process 
Name. The business 
process for which 
cr^h^dule 

information has to 
be deleted. 




1 Aut ho r i 2 e Iden t i t y 


IDEN 


Identity of the 
person deleting 
scheduler 
information . 




IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 





Return Value 

Schedule information deleted. 



Server Administration API 

The following details the methods of workflow 
server manager (WSM) classes, which are also the 
internal APIs that are used to achieve the 
functionality of the workflow server manager. . 

AWS St art Server 

This call starts the workflow server reading the 
configuration information from a parameter file. The 
server can be shutdown by issuing AWSStopServer call. 
The API establishes a session of the workflow server 
with the underlying database server and starts the 
workflow server operations. 

Syntax 

void FAR PASCAL AWSStartServer 

Parameters 
None . 



SUBSTITUTE SHEET (RULE 26) 



wo 94/18620 



197 



PCT/US94/01287 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSStopServer 

This call stops the workflow server operations. 
The transaction manager No requests from client 
applications are processed after this call is made. 

Syntax 

void FAR PASCAL AWSStopServer 

Parameters 

None . 

Return Value 

Success — AWSError =0 

Failure — AWSError <> 0 
AWS Grant 

This call grants the specified privileges to the 
user by creating an authorization record for the user, 
object and the action in the privileges table. The 
granted privileges can be revoked by calling AWSRevoke 
function. 

Syntax 

void FAR PASCAL AWSGrant ( IDENUserld, eObject, eAction 
) 
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Parameters 



Name 


Tvpe 


Description 


IDENUserld 


IDENTITY 


Id of the user who is 
being granted with the 
TDrivileae . 


eObject 


OBJECT 


Object on which 
privilege is being 
aranted . 


eAction 


ACTION 


Action for which the 
privileges are being 
aranted. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSRevoke 

This call revokes the privileges granted to the 
user with a previous call to AWSGrant by deleting the 
record for user, object, and action form authorization 
table. 

Syntax 

void FAR PASCAL AWSRevokePrivilege ( IDENUserName , 
eObject, eAction ) 



Parameters 



Name 


Tvpe 


Description 


I DENU s e r N ame 


IDENTITY 


Id of rhe user whose 
privilege is being 
revoked . 


eOb ject 


OBJECT 


Object on which 
privilege is being 
revoked. 


eAction 


ACTION 


Action for which the 
privileges are being 
revoked. 
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Return Value 

Success — AWSError 0 

Failure — AWSError <> 0 

AWSAbortBP 

This call marks specified business process 
instance in transaction database as aborted by 
changing the status of BP Transaction instance class 
(TxBPInstance) . 

Syntax 

void FAR PASCAL AWSAbortBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
aborted. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSDeleteBP 

This call deletes specified business process 
instance from transaction database. 

Syntax 

void FAR PASCAL AWSDeleteBP ( IpszBPTId ) 
Parameters 
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Name 


Type 


Des cr Ip't xon 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
deleted from Transaction 
database . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSSuspendBP 

This call suspends the execution of specified 
business process instance by changing the status of BP 
transaction instance class (TxBPInstance) . No 
transactions can take place on the business process 
till it is restarted again by a call to AWSRestartBP . 

Syntax 

void FAR PASCAL AWSSuspendBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
suspended. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSResumeBP 
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This call restarts specified business process 
instance in transaction database, suspended previously 
by a call to AWSSuspendBP . 

Syntax 

void FAR PASCAL AWSResumeBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
restarted. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSArchiveBP 

This call archives a business process or all 
completed business processes on the specified media. 
The archived business processes are deleted from the 
database. This function will in turn use AWSBackup 
function for backing up the data on a different media. 

Syntax 

void FAR PASCAL AWSArchiveBP < IpszBPName, 
eArchiveMedia, ArchiveTime,. ArchiveDate ) 

Parameters 

None . 
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IpszBPName 



e Ar Chi veMe dia 



ArchiveDate 



AcrhiveTime 



STRING 



ENUM 



TIME 



TIME 



PCTAJS94/01287 




The Business Process 
name. This name should 
be unique. If a business 
process with the same 
name is present, the 
current definition is 
over written as a new 
version. There should be 
no active instances of 
the current definition 
4=^^ to occur 



The media to which the 
business process is to 

be archived. 

The date on which 
archiving is done. 



The time on which 
archiving is done. 



Return Value 

Success — AWSError = 0 



Fai 



lure — AWSError <> 0 



AWSListAvailBPs 

This call lists all the business processes by 
running through the definitions database to find out 
all instances of BP definirion class (DfBP) . 

Syntax 

void FAR PASCAL AWSListAvailBPs 

Parameters 

None . 

Return Value 

Success — AWSError = 0 



Failure — AWSError <> 0 
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AWSList:ActiveBPs 

This call lists all the active business processes 
by running through the transactions database and 
finding out all instances of TxBP Instances that have 
status as 'Active'. 

Syntax 

void FAR PASCAL AWSListActiveBPs 

Parameters 

None . 

Ret:urn Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSDeleteBP Definition 

This call deletes the definition of specified 
business process from the definitions database by 
using VDB method DeleteBP of class Df BP . 

Syntax 

void FAR FASCAL AWSDeleteBPDef init ion ( IpszBPDId ) 



Parameters 



Mame 


Type 


Description 


IpszBPDId 


STRING 


Id of the Business 
Process that has to be 
deleted from definitions 
database . 
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Return Value 

Success — AWSError - 0 

Failure — AWSError <> 0 

AWSListActiveWF 

This call lists all active workflows in the 
specified business process by using VDB method Li 
of class TxBPInstance. 

Syntax 

void FAR PASCAL AWSListActiveWF ( IpszBPName ) 



Parameters 



Name 


Tvpe 


Description 


IpszBPName 


STRING 


Name of the Business 
Process whose active 
workflows are to be 
listed. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSRegister 

This call registers the new STF Processor name in 
the Names and Routing database by using VDB method 
CreateSTFDefn . 

Syntax 

void FAR PASCAL AWSRegister ( IpszSTFProcessorName ) 
Parameters 
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Name I Type I Description 

iPSzSTFProcessorName I STRING I The STF Processor name. 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSDeregister 

This, call deregisters an STF Processor name from 
the server Names and Routing database, previously 
registered by AWSRegister call. 

Syntax 

void FAR PASCAL AWSDeregister ( Ips zSTFProcessorName ) 



Parameters 



Name 


Type 


Des cription 


loszSTFProcessorName 


STRING 


The STF Processor nam.e . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSClieck 

This call checks a particular workflow server 
database for consistency and integrity. The API will 
in turn use appropriate database APIs to provide the 
functionality . 

Syntax 
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void FAR PASCAL AWSCheck 

Parameters 

None . 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSIndeac 

This call reindexes a particular workflow server 
database. The API will in turn use appropriate 
database APIs to achieve the functionality. 

Synt ax 

void FAR PASCAL AWS Index 

Parameters 

None . 

Return Value 

Success — AWSError =0 

Failure — AWSError <> 0 

AWS Reorganize 

This call reorganizes a particular workflow 
server database, to permanently remove the records 
marked for deletion. The API will in turn use 
appropriate database APIs to achieve the 
functionality. 

Syntax 
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void FAR PASCAL AWSReorganize 

Parameters 
None . 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWS Set Con figuration 

This call updates the configuration information 
in the parameter file. The information can later be 
retrieved by making a call to AWSGetConf iguration . 

Syntax 

void FAR PASCAL AWSSetConf iglnf o ( iMaxBPCount, 
pszVersion, IpszLogFileName, IpszLogFilePath ) 



Parameters 



Name 


Type 


Description 


iMaxBPCount 


INT 


Maximum number of active 
business processes on the 
server. 


iDSzVersion 


STRING 


Ve r s ion numbe r . 


Ips z LoaF i 1 eName 


STRING 


Transaction loQ file name. 


IpszLogFilePath 


STRING 


Path where transaction log 
file will be written. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSGetConf iguration 
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This call reads the configuration information 
from the parameter file, earlier written by calling 
AWSSetConf iglnf o , 

Syntax 

void FAR PASCAL AWSGetConf iguration ( iMaxBPCount, 
Ips z Vers ion , Ips zLogF i leName , 

IpszLogFilePath > 



Parameters 



Name 


Tvpe 


Description 


iMaxBPCount 


INT 


Maximum number of active 
business processes on 
the server. 


IpszVersion 


STRING 


Version number. 


IpszLogFileName 


STRING 


Transaction log file 
name . 


IpszLogFilePath 


STRING 


Path where transaction 
log file will be 
written . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSWriteToLog 

This call causes transaction information to be 
written to the workflow server log file . 

Synt ax 

void FAR PASCAL AWSWriteToLog ( IpszTransInf o ) 
Parameters 
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Name 


Type 


Description 


IpszTransInf o 


STRING 


Transaction information 
to be written to loa. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

Reporter API 

Get all the BP Names 

Input Parameters : 
None 

Output Parameters : 

Array of BP Names and their versions existing in 
the database 

Get BP information using BP name 

Input Parameters : 

BP Name 
BP Version 

Output Parameters : 

BP Owner 
BP Administrator 
Primary Workflow Name 
Projected cycle time 
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Get BP Instance ids of a BP 

Input Parameters : 

BP name 
Output Parameters: 

Array of BP instance ids . 

Get Workflow Names of a BP 
Input Parameters : 

BP name 
Output Parameters : 

List of workflow names 

Get BP Instance data 
Input Parameters : 

BP instance id 

Output Parameters : 

BP instance status 
BP name 

Primary workflow instance id 
List of workflow instance ids. 

Get Workflow Instance Ids of a Workflow 

Input Parameters: 
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Workflow name 
Output Parameters : 

List of workflow instance ids along with its BP 
instance ids. 

Get Workflow Definitional Data 

Input Parameters : 

BP name 
Workflow name 

Output Parameters : 

Workflow computed cycle time 
Workflow type 

Customer's organization role 

Performer's organization role 

Observers' organization roles 

Customer's default identity 

Performer's default identity 

Observers' default identities 

timel (Customer request cycle time) 

time2 (Performer response cycle time) 

time3 (Performer completion cycle time) 

time4 (Customer declare satisfaction cycle time) 

Conditions of satisfaction 

Get Workflow Instance Data 

Input Parameters : 

BP instance id. 
Workflow instance id. 
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Output Parameters : 

The current workflow state 
Workflow name 
Customer identity 
Performer identity 
Observer identities 
Workflow starting time 
User specified completion time 
Workflow actual completion time 
User specified cycle time of phasel 
User Efpecified cycle time of phase2 
User specified cycle time of phaseS 
User specified cycle time of phase4 
Actual cycle time of phasel 
Actual cycle time of phase2 
Actual cycle time of phaseS 
Actual cycle time of phase4 

Get Workflow Summary Historical Data 

Input Parameters : 

BP name 
Workflow name 

Output Parameters : 

Average completion time of a workflow 
Best completion time of a workflow 
Worst completion time of a workflow 
Average cycle time for the customer request of a 
workflow 

Best cycle time for the customer request of a 
workflow 

Worst cycle time for the customer request of a 
workflow 
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Average cycle time for the performer response of 
a workflow 

Best cycle time for the performer response of a 
workflow 

Worst cycle time for the performer response of a 
workflow 

Average cycle time for the performer completion 
of a workflow 

Best cycle time for the performer completion of a 
workflow 

Worst cycle time for the performer completion of 
a workflow 

Average cycle time for the customer declare- 
satisfaction of a workflow 

Best cycle time for the customer declare- 
satisfaction of a workflow 

Worst cycle time for the customer declare- 
satisfaction of the workflow 

Total number of instances of a workflow 

Number of workflow instances which were delayed 
.Average delay of delayed workflow instances 

Maximum delay of the workflow 

Number of workflow instances which were canceled 
Number of workflow instances which were revoked 
Number of workflow instances which were declined 
Number of workflow instances with customer 

request phase delayed 

Average delay in customer request phase 
Maximum delay in customer request phase 
Number of workflow instances with performer 

response phase delayed 

Average delay in performer response phase 
Maximum delay in performer response phase 
Number of workflow instances with performer 

completion phase delayed 

Average delay in performer completion phase 
Maximum delay in performer completion phase 
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Number of workflow instances with customer 
declare-satisfaction phase delayed 

Average delay in customer declare-satisfaction 

phase 

Maximum delay in customer declare-satisfaction 

phase 

Get Acts Taken in a Workflow instance 

Input Parameters : 

BP instance id 
Workflow instance id 

Output Parameters : 

The following details of acts taken: 
Act Taken 

Identity who took the act 
When the act was registered 
Complete by time of the act 
Respond by time of the act 
When the act was performed 

Get BP Names of a BP Collection 

Input Parameters ; 

Selection criteria based on (refer BP Collection 
query dialog box in section 6.3,1): 
BP Name 

Customer, performer and observer organizational roles 
Customer, performer and observer default identities 
Check primary/all workflow (s) flag 
Include all/latest version (s) flag 

Output Parameters : 
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The following details of selected BPs : 
BP Name 
BP Version 
BP Owner 
BP Administrator 
Primary Workflow Name 

Get BP Instance ids of a BP 

Input Parameters : 
BP name 

Selection criteria based on (refer BP Instance 
Selection dialog box in section 6,3.5): 

From and To Dates 

Customer, performer, observer identities 
Check primary/all workflow (s) flag 

Include exceptions (Delay/Cancel/Revoke/Decline/Normal) 
flag 

Output Parameters : 

Array of BP instance ids, 

C. WORKFLOW SERVER MANAGER (WSM) 

The following is a description of the workflow 
server manager (WSM) component of the workflow system. 
The WSM uses the workflow APIs to implement the 
functions and services it provides to users. The WSM 
is a component of the workflow system that provides a 
user interface for specific services of the workflow 
server such as : 

Server Management 

Authorization Maintenance 

Business Process Maintenance 
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Workflow Maintenance 

STF Processor Maintenance 

Configuration 

Transaction Log Maintenance 

Business Process Scheduling and Organizational 
Calendar 

Through the use of the WSM, a user selects the 
scheduling function which provides the user interface 
to specify the . recurrent scheduling of business 
processes as well as the specification of the 
organizational calendar as specified by the schedule 
manager . 



Workflow Server Manager classes 

The following is a description of the WSM classe 
with their attributes and methods . 

Server Management 

Server 

This class handles server management activities, 
such as server startup, shutdown, etc. Startup 
'establishes a workflow server session with the 
underlying database server and starts up transaction 
manager activities. 
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At: tributes 1 






InszServerlD 


string 


Methods 








AWSStartServer 


The method starts 
the server 
operations by 
opening a session 
with the underlying 
database server and 
starts Transaction 
Manager operations . 




AWSStopServer 


The method notifies 
all active users 
about the shutdown, 
disconnects from 
database server, 
and shuts down the 
Transaction Manager 
operations . 



Au^horlzaiilon Maintenance 
Object 

This class provides methods to create 
objects . 



Attributes 








Qbi^Ctld 


ref(BP) or ref(WF) 




eObiectType 


ob jecttype 
Enumerations of 
Objects are 
Business Processes 
Workflows 



Authorization 

This class provides methods to grant/revoke 
authorities to users to act on objects. 
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AWSGrant 



AWSRevoke 
AWSInquire 
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actions 

Enumerations for Actions 



are 



Create 
Delete 
Modify 
Instantiate 

View 




The method grants 
authority to a user to 
make the specified act on 
the specified object. 
The method revokes a 
previously granted 
^nt-hority -P^^^ user. 
The method is used to 
inquire whether user has 
authority to make 
specified act on the 
specified object. 



Business Process Maintenance 



BPMaint 



This class provides methods to maintain business 
processes in definitions and transactions databases. 
It provides methods for archiving all completed 
business processes. 
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Mot-Viftfis 1 1 1 




AWSAbortBP 


The method aborts 
a BP instance . 




AWSDeleteBP 


The method deletes 
the specified BP 
instance from the 
transaction 
database . 




AWSSuspendBP 


The method 
suspends the 
operations of a BP 
instance 
temporarily. 




AWSResumeBP 


The method resumes 
a BP instance 
previously 
suspended . 




AWSArchiveBP 


The method 
archives a BP 
instance or all 
completed BPs. 




AWSL i s t Ava i IBP s 


The method lists 
all BPS available 
in definitions 
database . 




AWSListActiveBPs 


The method lisrs 
all BPs active in 
transactions 
database . 




AWSDeleteBPDef inition 


The method deletes 
a BP definition 
from definitions 
database . 



Workflow Maintenance 



WFMaint 

This class handles housekeeping of workflows in a 
business process. 



Methods 








AWSListActiveWF 


The method lists all 
active workflows for 
a BP instance. 



STF Processor Maintenance 
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STFProcessor 

This class handles registration and 
deregistration of STF Processors in Names and 
database . 









AWSRegister 


The method 
registers an STF 
Processor in Names 
and Routing 
database . 




AWSDeregister 


The method 
deregisters an STF 
Processor from 
Names and Routing 
database . 



Dat;abase Management 
DBMgmt 

This class handles various database management 
functions, such as checking a particular workflow 
server database for integrity, reindexing the . 
database, and reorganizing the database. 



Methods 








AWSCheck 


The method checks 
the database for 
consistency and 
coherency , 




AWSIndex 


The method 
reindexes the 
database , 




AWSReorganize 


The method 
reorganizes the 
database . 



Configuration 
Conf ig 

This class provides methods to set and inquire 
various configurable parameters. 
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Attributes 








iMaxOpenBPs 


int 




ipszVersion 


strina 




XpSZijOCfr ixexNciuie 


st r inQ 




ipszLooFilePath 


strina 


Methods 


AWSSetConf igurat ion 


The method set the 
configuration 
parameters to 
specified value. 




AWSGetConf igurat ion 


The method 
retrieves 
conf igurat ion 
parameters from 
the file. 



Traxisact:ion Log Maintenance 
TransLog 

This class provides methods to maintain 
transaction log. The workflow processor uses this 
method to write all changes in the workflow status to 
the log . 



Methods 








AWSWriteToLog 


The method writes 
the specified 
string to the 
transaction loa . 
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CI*AIMS 

1, A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services to workflow enabled applications that 
5 allow users to act and participate in said 
business processes comprising: 

a) workflow server means for providing: 
i) transaction services for 

,1. initiating the workflows; 

2. taking actions in initiated 
workflows; 

3. updating and maintaining 
workflow status after each 
act is taken in a 
predetermined one of said 
initiated workflows and 
keeping track of pending 
workflow activities; 

4. producing reports specifying 
20 available business processes 

that a predetermined one of 
said workflow enabled 
applications can initiate; 
b) database means for storing records of 
25 workflow transactions. 

2. A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services that allow designers to analyze and 
5 design business processes and applications 

comprising : 

a) workflow server means for providing: 
i) definitions services for: 

1. defining elements of a 
business process, its 
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workflows and workflow 
links ; 

2. defining structures for the 
workflows of the business 
15 process; 

ii) names and routing services for: 

1. defining roles associated 
with the workflows; 

2. defining identities 

20 associated with defined 

roles ; 

b) database means for storing records of: 

i) definitions of an organization, 
business processes of the 

25 organization, workflows of the 

business processes, roles and 
acts associated with the 
workflows ; 

ii) the roles and identities of users 
30 within an organization utilizing 

the workflow system. 

3, A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services to workflow enabled applications that 
5 enable managers to observe and query the status 
of said workflows and business processes 
comprising : 

a) workflow server means for providing: 
i) transaction services for 
10 1. initiating the workflows; 

2. taking actions in initiated 
workflows; 

3. updating and maintaining 
workflow status after each 

15 act is taken in a 
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20 



25 b) 



30 



35 



predetermined one of said 
initiated workflow; 

4. producing lists of workflows 
with pending actions; 

5. producing reports specifying 
available business processes 
that a predetermined one of 
said workflow enabled 
applications can initiate; 

database means for storing records of: 

i) definitions of an organization, 
•business processes of the 

organization, workflows of the 
business processes, roles and 
acts associated with the 
workflows; 

ii) workflow transactions; 

iii) the roles and identities of 
customers, perfomers and 
observers utilizing the workflow 
system. 

4. The system defined by Claim 1 wherein 
said workflow server means provides transaction 
services for producing lists of workflows with 
pending actions - 

5. The system defined by Claim 1 wherein 
said database means is for storing records of the 
date and time when a business process must be 
initiated. 

6. The system defined by Claim 1 wherein 
said database means is for storing configuration 
information used by the workflow server means. 

7. The system defined by Claim 1 wherein 
said database means is for storing notifications 



SUBSTITUTE SHEET (RULE 26) 



wo 94/18620 



225 



PCT/US94/01287 



to be sent to users that interact with the 
workflow system through a standard transaction 
5 format processor interface. 

8 . The system defined by Claim 1 further 
comprising application program interface means 
for providing an interface to the server means to 
enable workflow enabled applications to obtain 

5 access to the services provided by the server 
means . 

9. The system defined by Claim 1 wherein 
said workflow server means provides transaction 
services for binding application specific data to 
a workflow transaction. 

10 The system defined by Claim 1 wherein 
said workflow server means provides definitions 
services for defining elements of a business 
process, its workflows and workflow links. 

11, The system defined by Claim 1 wherein 
said workflow server means provides definitions 
services for defining structures for the 
workflows of a business process. 

12, The system defined by Claim 1 wherein 
said workflow server means provides names and 
routing services for defining roles and defining 
identities . 

13, The system defined by Claim 1 wherein 
said workflow server means provides configuration 
services for defining a network configuration of 
the workflow system, the version of the server 

5 means, registering standard transaction format 
processors, defining users, specifying a log 
database and a level of logging required. 
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14. The system defined by Claim 1 wherein 
said workflow server means provides scheduling 
services for allowing an authorized user to 
create, modify and delete records of scheduled 

5 business processes. 

15. The system defined by Claim 1 further 
comprising means for updating the workflow server 
databases as an interface to the server means to 
enable workflow enabled applications to obtain 

5 access to services provided by the server means. 
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Fig. 4a 
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